Skip to main content
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

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

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 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 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.
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:

​
Configure in the Dashboard

1

Add Nomupay to your Dashboard

Go to Integrations, select New integration, search for Nomupay, and enter your credentials.
2

Activate the payment methods on the Checkout

Go to Checkout and activate the payment methods you want to offer.
3

Route payments with Workflows

In Workflows, 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:

​
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.
Use the following test cards with CVV 333 and expiry 01/30.

​
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.