Pay.
Принимайте кредитные карты, цифровые платежи и купи сейчас, плати потом
Pay. payments for Medusa V2
Get access to 50+ payment options for online and in-store payments.
Getting Started
Don’t have an account with Pay. yet? Register now!
Осторожно
If you have subscribers listening to the event, update them to listen to the event instead. See below.
Предупреждение
This plugin creates orders in Medusa immediately, even if the payment has not yet been captured. If a payment expires, is cancelled or fails, the associated order will be automatically canceled.
This change in flow is required to support asynchronous payment methods (e.g., SprayPay), where payment confirmation can take hours depending on customer input.
Table of Contents
- Demo store
- Pay. Payment Methods
- Features
- Prerequisites
- Installation
- Configuration
- Usage
- Supported Payment Methods
- Client-Side Integration
- Extending the Plugin
- Medusa v1 Support
Demo store
Visit the demo store here: https://pay-demo.webbers.com
Pay. payment methods
Card payment methods
- Mastercard
- VISA
- American Express
- Carte Bancaire
- Maestro
- PostePay
- DanKort
- Nexi
- Visa Mastercard
Digital wallets
- Apple Pay
- Google Pay
Afterpay methods / Buy now pay later
- iDEAL IN3
- Billink
- SprayPay
- Riverty
- Mondu
- AlmaPAY
- Klarna
Other
- PayPal
Recurring payments
- SEPA Direct Debit
- Card-on-file / recurring card payments (tokenisation) [Coming soon]
Region specific payment methods
Payment Method | Region(s) |
|---|---|
| iDEAL | 🇳🇱 Netherlands |
| Bancontact | 🇧🇪 Belgium |
| Vipps | 🇳🇴 Norway 🇸🇪 Sweden |
| Bizum | 🇪🇸 Spain |
| Payconiq | 🇧🇪 Belgium 🇱🇺 Luxembourg |
| Twint | 🇨🇭 Switzerland |
| MB Way | 🇵🇹 Portugal |
| Pay By Bank | 🇧🇪 Belgium 🇩🇪 Germany 🇮🇹 Italy 🇱🇺 Luxembourg 🇳🇱 Netherlands 🇪🇸 Spain |
| WeChat Pay | 🇨🇳 China |
Payment Method | Region(s) |
|---|---|
| Alipay Plus | 🇨🇳 China 🇭🇰 Hong Kong |
| MultiBanco | 🇵🇹 Portugal |
| Swish | 🇸🇪 Sweden |
| Satispay | 🇮🇹 Italy |
| Blik | 🇵🇱 Poland |
| EPS | 🇦🇹 Austria |
| Przelewy24 | 🇵🇱 Poland |
| MobilePay | 🇩🇰 Denmark 🇫🇮 Finland |
InStore / SoftPOS payments
Would you like to integrate Pay. (Soft)P0S? Get in touch!
Features
- Easily Extendable: The modular architecture makes it easy to add support for additional Pay payment methods.
- Webhook Support: Full support for Pay webhooks for real-time payment status updates.
- Automatic Capture: Configurable automatic capture of payments.
Prerequisites
- Medusa server v2.20.1 or later
- Node.js v20 or later
- A Pay account and token & secret with payment methods enabled.
Installation
Configuration
Add the provider to the module in your file & add it as plugin:
Configuration Options
Примечание
You can get the API token & secret from your Pay dashboard: click Settings > Click sales channel > Copy api tokens
| Option | Description | Default |
|---|---|---|
| Your Pay AT code | Required | |
| Your Pay API token | Required | |
| Your Pay sales channel code | Required | |
| Your Pay sales channel secret | Required | |
| The URL to return to after payment | Required | |
| The URL of your Medusa server | Required | |
| Whether to enable test payments | Optional | |
| Pay TGU API Url | Optional, use if you want to use a specific or private TGU, see here. | |
| Your other Pay sales channel code and secrets | Optional, used for webhook signature validation when using multiple Pay. sales channels. Format |
Environment Variables
Create or update your file with the following variables:
Usage
Once installed and configured, the Pay payment methods will be available in your Medusa admin. To enable them, log in to you Medusa Admin, browse to Settings > Regions, add or edit a region and select the desired Pay providers from the dropdown.
Make sure that the selected payment methods are enabled in your Pay origanization settings as well.
Testing direct debits locally
Pay.'s test environment does not process SEPA direct debits. With enabled the plugin therefore does not create a mandate at Pay. when a direct debit order is placed. It stores a simulated mandate on the payment session instead (code , logged as ), and the collection flow can be driven by posting the exchanges Pay. would normally send to the webhook route yourself. Exchanges for a simulated mandate are not re-fetched from Pay., the body is taken as the direct debit state. This only happens while is on and only for mandates that were created in test mode.
Other legacy actions (, ) and an explicit (failed) or work the same way. Add to the body when the order can not be resolved from the mandate code. The webhook route processes exchanges asynchronously (5 seconds by default), so give the server a moment before checking the order. The payment link opens the regular Pay. hosted checkout, so the outstanding amount can be paid with any test payment method.
Reversed payments in the admin
When a chargeback or storno reverses a captured payment, the plugin refunds the payment in Medusa (without contacting Pay.), books the amount as outstanding again and opens a new payment collection, so the order offers "Copy payment link" and "Mark as paid". Medusa's own payment status can only call that "Refunded", so the plugin adds a "Payment reversed, action required" banner on top of the order page that names the cause (chargeback, storno, failed collection), the amount that went back to the customer and what is still outstanding. Once the outstanding amount is paid (through the payment link or "Mark as paid") the banner turns green and reads "Storno paid", "Chargeback paid" or "Failed collection paid", keeping the reversal visible in the order's history.
Simulator widget in the admin
The same exchanges can be triggered from the order detail page. Switch on SEPA testing in Settings > Pay (off by default, meant for staging servers) and a "Pay. direct debit simulator" panel appears in the sidebar of orders that hold a simulated mandate, with a button per exchange (pending, sent, collected, storno, failed, declined). The exchanges are processed synchronously, so the order refreshes right away. The switch is stored in the store's metadata (), so it applies to every admin user of that server. The panel is backed by and (), which only work while the switch and are on; the switch itself is read and written through / ().
Supported Payment Methods
The plugin currently supports the following Pay payment methods:
Payment Method | Provider ID |
|---|---|
| Pay. hosted checkout | |
| Creditcards Mastercard / VISA / American Express/ Carte Bancaire / Maestro / PostePay / DanKort / Nexi / Visa Mastercard | |
| Card-on-file / recurring card payments (tokenisation) | Coming soon |
| Apple Pay | |
| Google Pay | |
| iDEAL IN3 | |
| Billink | |
| SprayPay | |
| Riverty | |
| Mondu | |
| AlmaPAY | |
| Klarna | |
| PayPal | |
| SEPA Direct Debit | |
| iDEAL | |
| Bancontact | |
| Vipps | Get in touch |
| Bizum | Get in touch |
| Payconiq | |
| Twint | |
| MB Way | Get in touch |
| Pay by Bank | |
| WeChat Pay | |
| AliPay Plus | Get in touch |
| MultiBanco | Get in touch |
| Swish | Get in touch |
| Satispay | Get in touch |
| Blik | |
| EPS | |
| Przelewy24 | |
| MobilePAY | |
| SoftPOS | |
| Gift Card |
Client-Side Integration
To integrate with your storefront, you'll need to implement the payment flow according to Pay's and Medusa's documentation. Here's a basic example:
- Create a payment session in your checkout flow
- Redirect the customer to the Pay payment page
- Handle the webhook notifications to update the payment status
Example integration using the Medusa Next.js Starter:
Duplicate cart endpoint
Совет
Use the duplicate cart endpoint in your storefront
When a customer cancels a payment or returns to the storefront without completing the Pay. checkout, a new duplicate cart should automatically be created. This allows the customer to easily start a new transaction without losing the items they had selected.
API Route:
Alter your storefront retrieve cart function(s) and check if the returned cart.completed_at value is set. If so request a new cart with the duplicate cart endpoint and update cart id in cookies accordingly.
The duplicate cart endpoint is idempotent, so it can be called multiple times with the same cart id.
Adding payment method icons
- Download the latest payment images from here: https://github.com/paynl/payment-images
- Add these to your storefront public assets
- In your checkout, create the mapping from the provider id to the icon.
- You can also utilize the exported from this plugin to find the corresponding ID.
- I.e.
Extending the Plugin
To add one of the missing Pay payment methods, create a new service in that extends the class:
Make sure to replace with the actual Pay payment method ID.
Export your new service from . Then add your new service to the list of services in .
We will be working on providing all the available Pay. options in the near future.
Medusa v1 Support
Searching for support for Medusa v1, we have a legacy plugin available. Get in touch

