Pay.com

Name: MedusaJS
Brand: Medusa

Accept credit cards, digital and buy now pay later with Pay's API

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!

[!CAUTION] If you have subscribers listening to the Copy to clipboardorder.placed event, update them to listen to the Copy to clipboardpayment.captured event instead. See below.

[!WARNING] This plugin creates orders in Medusa immediately, even if the payment has not yet been captured. If a payment expires, 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.

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

1
pnpm add @webbers/pay-payments-medusa

Configuration

Add the provider to the Copy to clipboard@medusajs/payment module in your Copy to clipboardmedusa-config.ts file & add it as plugin:

1234567891011121314151617181920
module.exports = defineConfig({
  projectConfig: {
    // ...
  },
  plugins: [
    // ... other plugins
    '@webbers/pay-payments-medusa'
  ],
  modules: [
    // ... other modules
    {
      resolve: "@medusajs/medusa/payment",
      options: {
        providers: [
          {
            resolve: "@webbers/pay-payments-medusa/providers/pay",
            id: "pay",
            options: {
              paymentDescription: "Your description", // optional
              atCode: process.env.PAY_AT_CODE,

Configuration Options

[!NOTE] You can get the API token & secret from your Pay dashboard: click Settings > Click sales channel > Copy api tokens

Option Description Default Copy to clipboardatCode Your Pay AT code Required Copy to clipboardapiToken Your Pay API token Required Copy to clipboardslCode Your Pay sales channel code Required Copy to clipboardslSecret Your Pay sales channel secret Required Copy to clipboardreturnUrl The URL to return to after payment Required Copy to clipboardmedusaUrl The URL of your Medusa server Required Copy to clipboardtestMode Whether to enable test payments Optional Copy to clipboardtguApiUrl Pay TGU API Url Optional, use if you want to use a specific or private TGU, see here. Copy to clipboardotherSlCodes Your other Pay sales channel code and secrets Optional, used for webhook signature validation when using multiple Pay. sales channels. Format Copy to clipboard'{"SL-CODE-X":"secretX","SL-CODE-Y":"secretY"}'

Environment Variables

Create or update your Copy to clipboard.env file with the following variables:

123456
PAY_AT_CODE="<your-pay-at-code>"
PAY_API_TOKEN="<your-pay-api-token>"
PAY_SL_CODE="<your-pay-sl-code>"
PAY_SL_SECRET="<your-pay-sl-secret>"
#PAY_TEST_MODE="true"
PAY_EXCHANGE_URL="https://your-store.com/checkout/payment"

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.

Supported Payment Methods

The plugin currently supports the following Pay payment methods:

Payment Method Provider ID Pay. hosted checkout Copy to clipboardpp_pay-hosted-checkout_pay Creditcards
Mastercard / VISA / American Express/ Carte Bancaire /
Maestro / PostePay / DanKort / Nexi / Visa Mastercard Copy to clipboardpp_pay-creditcard-group_pay Card-on-file / recurring card payments (tokenisation) Coming soon Apple Pay Copy to clipboardpp_pay-apple-pay_pay Google Pay Copy to clipboardpp_pay-google-pay_pay iDEAL IN3 Copy to clipboardpp_pay-ideal-in3_pay Billink Copy to clipboardpp_pay-billink_pay SprayPay Copy to clipboardpp_pay-spraypay_pay Riverty Copy to clipboardpp_pay-riverty_pay Mondu Copy to clipboardpp_pay-mondu_pay AlmaPAY Copy to clipboardpp_pay-almapay_pay Klarna Copy to clipboardpp_pay-klarna_pay PayPal Copy to clipboardpp_pay-paypal_pay SEPA Direct Debit Copy to clipboardpp_pay-direct-debit_pay iDEAL Copy to clipboardpp_pay-ideal_pay Bancontact Copy to clipboardpp_pay-bancontact_pay Vipps Get in touch Bizum Get in touch Payconiq Copy to clipboardpp_pay-payconiq_pay Twint Copy to clipboardpp_pay-twint_pay MB Way Get in touch Pay by Bank Copy to clipboardpp_pay-paybybank_pay WeChat Pay Copy to clipboardpay-wechatpay AliPay Plus Get in touch MultiBanco Get in touch Swish Get in touch Satispay Get in touch Blik Copy to clipboardpp_pay-blik_pay EPS Copy to clipboardpp_pay-eps_pay Przelewy24 Copy to clipboardpp_przelewy24_pay MobilePAY Copy to clipboardpp_pay-mobilepay_pay SoftPOS Copy to clipboardpp_pay-softpos_pay Gift Card Copy to clipboardpp_pay-giftcard_pay

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:

https://github.com/user-attachments/assets/742ee261-5e41-4e33-9a72-faf1a424fc52

Duplicate cart endpoint

[!TIP] 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: Copy to clipboardGET /store/carts/:id/duplicate

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 Copy to clipboardpayPaymentMethods from this plugin to find the corresponding ID.
I.e. Copy to clipboardconst paymentMethodData = payPaymentMethods.find(method => `pp_${method.value}_pay` === provider_id)

Extending the Plugin

To add one of the missing Pay payment methods, create a new service in Copy to clipboardsrc/providers/Pay/services that extends the Copy to clipboardPayBase class:

123456789101112131415
import {PaymentMethod} from "@Pay/api-client";
import PayBase from "../core/Pay-base";
import {PaymentOptions, PaymentProviderKeys} from "../types";

class PayNewMethodService extends PayBase {
  static identifier = "Pay-new-method";

  get paymentCreateOptions(): PaymentOptions {
    return {
      method: PaymentMethod.newMethod,
    };
  }
}

export default PayNewMethodService;

Make sure to replace Copy to clipboardnew method with the actual Pay payment method ID.

Export your new service from Copy to clipboardsrc/providers/Pay/services/index.ts. Then add your new service to the list of services in Copy to clipboardsrc/providers/Pay/index.ts.

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