> ## Documentation Index
> Fetch the complete documentation index at: https://primer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Nomupay

> Process Card, Apple Pay, Google Pay, and alternative payment methods through Nomupay.

Nomupay is a payment processing platform. Connect Nomupay to Primer to process card payments, Apple Pay, Google Pay, and a wide range of alternative payment methods across European and Asian markets, and route them using Workflows.

## At a glance

### Supported payment methods

| Payment method | Payment method type | Integration guide |
| - | - | - |
| Card | `PAYMENT_CARD` | [Card](https://primer.io/docs/connections/payment-methods/card/overview.md) |
| Apple Pay | `APPLE_PAY` | [Apple Pay](https://primer.io/docs/connections/payment-methods/apple-pay/overview.md) |
| Google Pay | `GOOGLE_PAY` | [Google Pay](https://primer.io/docs/connections/payment-methods/google-pay/overview.md) |
| BLIK | `NOMUPAY_BLIK` | [BLIK via Nomupay](https://primer.io/docs/connections/payment-methods/blik/nomupay.md) |
| GCash | `NOMUPAY_GCASH` | [GCash via Nomupay](https://primer.io/docs/connections/payment-methods/gcash/nomupay.md) |
| GrabPay | `NOMUPAY_GRABPAY` | [GrabPay via Nomupay](https://primer.io/docs/connections/payment-methods/grabpay/nomupay.md) |
| P24 | `NOMUPAY_P24` | [P24 via Nomupay](https://primer.io/docs/connections/payment-methods/p24/nomupay.md) |
| Swish | `NOMUPAY_SWISH` | [Swish via Nomupay](https://primer.io/docs/connections/payment-methods/swish/nomupay.md) |
| TWINT | `NOMUPAY_TWINT` | [TWINT via Nomupay](https://primer.io/docs/connections/payment-methods/twint/nomupay.md) |
| Trustly | `NOMUPAY_TRUSTLY` | [Trustly via Nomupay](https://primer.io/docs/connections/payment-methods/trustly/nomupay.md) |
| WeChat Pay | `NOMUPAY_WECHAT_PAY` | [WeChat Pay via Nomupay](https://primer.io/docs/connections/payment-methods/wechat-pay/nomupay.md) |
| Wero | `NOMUPAY_WERO` | [Wero via Nomupay](https://primer.io/docs/connections/payment-methods/wero/nomupay.md) |

Nomupay uses Primer's standard card form and Primer's native Apple Pay and Google Pay integrations, so no Nomupay-specific SDK code is required for card payments and digital wallets.

### Supported capabilities

| Capability | Card | Apple Pay | Google Pay | BLIK | GCash | GrabPay | P24 | Swish | TWINT | Trustly | WeChat Pay | Wero |
| - | - | - | - | - | - | - | - | - | - | - | - | - |
| Authorization and capture | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Refunds | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Partial refunds | Yes | Yes | Yes | No | No | No | No | No | No | No | Yes | No |
| Merchant-initiated transactions | Yes | Yes | Yes | No | No | No | No | No | No | No | No | No |
| Cancel / Void | Yes | Yes | Yes | No | No | No | No | No | No | No | No | No |

WeChat Pay partial refunds are not available for merchants on the Hong Kong Nomupay account.

### 3D Secure

Primer performs 3D Secure authentication using the [Perform 3DS action](https://primer.io/docs/workflows/apps/native-apps/primer-payments-app/perform-3ds-action.md) and passes the result to Nomupay. Nomupay does not run its own 3D Secure for payments processed through Primer.

## Get started with Nomupay

### Before you begin

If this is your first connection, make sure to follow the [Get started guide](https://primer.io/docs/get-started/overview.md) to begin processing payments with Primer.

You need a Nomupay account. Contact Nomupay to provision a test account and a production account — credentials are provided on setup.

> [!NOTE]
>
> WeChat Pay and GrabPay require separate regional Nomupay accounts per market. Confirm with Nomupay which regional account covers your target region before onboarding.
>
> GCash in diaspora markets (Hong Kong, Singapore, EEA, UK) is currently in beta. Confirm availability with Nomupay before enabling.

### Credentials

Contact Nomupay to receive your credentials. Nomupay provides the following fields on account setup:

| Field | Where to find it |
| - | - |
| **kid** | Provided by Nomupay on account setup |
| **processingAccountId** | Provided by Nomupay on account setup |
| **sharedKey** | Provided by Nomupay on account setup |

### Configure in the Dashboard

**1. Add Nomupay to your Dashboard**

Go to [Integrations](https://dashboard.primer.io/integrations), select **New integration**, search for Nomupay, and enter your credentials.

**2. Activate the payment methods on the Checkout**

Go to [Checkout](https://dashboard.primer.io/checkout) and activate the payment methods you want to offer.

**3. Route payments with Workflows**

In [Workflows](https://primer.io/docs/workflows/overview.md), select Nomupay in the **Authorize payment** action for the payment methods you want to route to it. Add the **Perform 3DS** action before authorization for card payments.

### Prepare the client session

Most payment methods require no additional fields beyond the standard `orderId`, `currencyCode`, `amount`, and `customer` fields. The following exceptions apply:

| Parameter | Required | Applies to | Description |
| - | - | - | - |
| `customer.mobileNumber` | No | Swish | Swedish mobile number (e.g. `+46701234567`). If provided, opens the Swish app for in-app approval. If omitted, a QR code link is presented instead. |
| `paymentMethod.descriptor` | Yes | WeChat Pay | Merchant descriptor shown in the WeChat Pay checkout. Required by Nomupay. |

## Considerations

* **Saved cards and recurring payments.** Nomupay supports saved cards and merchant-initiated transactions for Card, Apple Pay, and Google Pay via the standard Primer vault flow. APMs do not support recurring or MIT.
* **WeChat Pay and GrabPay regional accounts.** Nomupay uses separate accounts per region for WeChat Pay and GrabPay. Confirm which regional account covers your target markets before going live.
* **WeChat Pay partial refunds.** Merchants on the Hong Kong Nomupay account are limited to a single full refund — partial refunds are not available.
* **Cancel / Void.** Only one partial cancellation is supported for card payments. APMs do not support cancellation.

## Test in sandbox

Connect your Nomupay test account to your Primer Sandbox environment.

> [tab] Card
>
> Use the following test cards with CVV `333` and expiry `01/30`.
>
> | Card number | Brand | Scenario |
> | - | - | - |
> | `4000000000000002` | Visa | Approve (no 3DS) |
> | `5555555555554444` | Mastercard | Approve (no 3DS) |
> | `6703444444444449` | Maestro | Approve (no 3DS) |

> [tab] Apple Pay
>
> Apple Pay payments use the same underlying card flow. Use a Visa or Mastercard from the sandbox card list in an Apple Pay-enabled test device.

> [tab] Google Pay
>
> Use an Android device with a Mastercard or Visa from the Google Pay test card suite.

> [tab] APMs
>
> APM flows in the Nomupay sandbox complete with simulated redirect flows. No real bank authentication takes place.

> [tab] Merchant-initiated
>
> Make a customer-initiated card payment that saves the card, then create a merchant-initiated payment with the saved payment method. Only Card, Apple Pay, and Google Pay support MIT.

## Go live

Before switching to production, confirm that:

1. Your production Nomupay credentials are active and you have added Nomupay in your Primer **production** environment.
2. All target payment methods are enabled on the Nomupay account for the relevant countries and currencies.
3. For WeChat Pay and GrabPay: the correct regional Nomupay account is configured for your target markets.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.