Skip to main content
Nuvei is a global payment technology platform. Connect Nuvei to Primer to process card payments, Apple Pay, Google Pay, and a wide range of alternative payment methods across Europe, the Americas, and Asia-Pacific, and route them using Workflows.

​
At a glance

​
Supported payment methods

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

​
Supported capabilities

​
3D Secure

Primer performs 3D Secure authentication using the Perform 3DS action and passes the result to Nuvei. Nuvei does not run its own 3D Secure for payments processed through Primer.

​
Get started with Nuvei

​
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 Nuvei merchant account for sandbox testing and a separate production account. Contact Nuvei to provision both.
To use network tokens with card payments, Nuvei requires the ShouldReturnSchemeReference configuration flag to be enabled on your account. Contact Nuvei support or your account manager before enabling network tokenization in production. Google Pay network tokens require a separate enablement request to Nuvei.

​
Credentials

Log in to Nuvei and go to Settings > My Integration Settings.

​
Configure in the Dashboard

1

Add Nuvei to your Dashboard

Go to Integrations, select New integration, search for Nuvei and enter your Merchant ID, Merchant Site ID, and Secret.
2

Add a chargeback webhook in Nuvei

In your Nuvei account, go to Settings > My Account > Events Configuration tab. Select your client, find the Chargeback actions, enter the callback URL shown in the Primer Dashboard, and save.
3

Activate the payment methods on the Checkout

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

Route payments with Workflows

In Workflows, select Nuvei 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. Nuvei 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.
  • Network tokens. Network tokenization requires the ShouldReturnSchemeReference flag to be enabled on the Nuvei account. Contact Nuvei support before enabling network tokens in production.
  • Instant Bank Transfer refunds. Instant Bank Transfer does not support refunds.

​
Test in sandbox

Connect your Nuvei test account to your Primer Sandbox environment.
Use the following test cards with any future expiry date and any CVV.

​
Go live

Before switching to production, confirm that:
  1. Your production Nuvei account is active and enabled for the payment methods you want to offer.
  2. You have added Nuvei in your Primer production environment using your production Merchant ID, Merchant Site ID, and Secret.
  3. You have configured the chargeback webhook in your Nuvei production account: Settings > My Account > Events Configuration > Chargeback > enter the Primer callback URL.
  4. If using network tokens, the ShouldReturnSchemeReference flag is enabled on your production Nuvei account. For Google Pay network tokens, confirm enablement separately with your Nuvei account manager.
  5. All target APMs are enabled on the Nuvei merchant account for the relevant countries and currencies.