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

# Nuvei

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

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

| 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) |
| BIZUM | `NUVEI_BIZUM` | [BIZUM via Nuvei](https://primer.io/docs/connections/payment-methods/bizum/nuvei.md) |
| EPS | `NUVEI_EPS` | [EPS via Nuvei](https://primer.io/docs/connections/payment-methods/eps/nuvei.md) |
| iDEAL | `NUVEI_IDEAL` | [iDEAL via Nuvei](https://primer.io/docs/connections/payment-methods/ideal/nuvei.md) |
| Instant Bank Transfer | `NUVEI_INSTANT_BANK_TRANSFER` | Instant Bank Transfer via Nuvei |
| MobilePay | `NUVEI_MOBILEPAY` | [MobilePay via Nuvei](https://primer.io/docs/connections/payment-methods/mobilepay/nuvei.md) |
| NPP | `NUVEI_NPP` | [NPP via Nuvei](https://primer.io/docs/connections/payment-methods/npp/nuvei.md) |
| Riverty | `NUVEI_RIVERTY` | [Riverty via Nuvei](https://primer.io/docs/connections/payment-methods/riverty/nuvei.md) |
| Swish | `NUVEI_SWISH` | [Swish via Nuvei](https://primer.io/docs/connections/payment-methods/swish/nuvei.md) |
| TWINT | `NUVEI_TWINT` | [TWINT via Nuvei](https://primer.io/docs/connections/payment-methods/twint/nuvei.md) |

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

| Capability | Card | Apple Pay | Google Pay | BIZUM | EPS | iDEAL | MobilePay | NPP | Riverty | Swish | TWINT | Instant Bank Transfer |
| - | - | - | - | - | - | - | - | - | - | - | - | - |
| 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 | No |
| Partial refunds | Yes | Yes | Yes | No | No | No | No | No | No | No | No | 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 |

### 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 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](https://primer.io/docs/get-started/overview.md) 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.

> [!NOTE]
>
> 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**.

| Field | Where to find it |
| - | - |
| **Merchant ID** | Shown on the **My Integration Settings** page |
| **Merchant Site ID** | Same page as Merchant ID |
| **Secret** | Same page — click **Reveal** to view |

### Configure in the Dashboard

**1. Add Nuvei to your Dashboard**

Go to [Integrations](https://dashboard.primer.io/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](https://dashboard.primer.io/checkout) and activate the payment methods you want to offer.

**4. Route payments with Workflows**

In [Workflows](https://primer.io/docs/workflows/overview.md), 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:

| Parameter | Required | Applies to | Description |
| - | - | - | - |
| `metadata.BIC` | No | iDEAL | Bank Identifier Code (BIC/SWIFT). When provided, skips the bank selection screen and sends the customer directly to their bank. |
| `metadata.EPS_Payer_Name` | No | EPS | Full name of the payer as it appears on their bank account. |
| `metadata.IBP_national_id` | No | Swish | Swedish national ID of the payer. When provided, enables in-app Swish payment. If omitted, a QR code is presented instead. |

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

> [tab] Card
>
> Use the following test cards with any future expiry date and any CVV.
>
> | Card number | Brand | Type | Country | Scenario |
> | - | - | - | - | - |
> | `4244951901005043` | Visa | Debit | GB | Approve |
> | `4761344136141390` | Visa | Debit | SG | Approve |
> | `5550343875851690` | Mastercard | Credit | ZA | Approve |
> | `5413037340736315` | Mastercard | Credit | DK | Approve |
> | `4083595312691240` | Visa | Debit | CZ | Soft decline — authentication advised |

> [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 Nuvei sandbox complete with simulated bank flows — no real bank authentication takes place. Nuvei sandbox APM requests are routed to `ppp-test.safecharge.com`.

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


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