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

# Nuvei - Card

> Connect to Nuvei to accept credit and debit card payments.

Nuvei is a global payment provider that provides comprehensive card processing solutions. The platform supports card payments with advanced features like delayed capture, over-capture, partial refunds, network tokenization, and digital wallet integration across multiple currencies and countries.

## Setup

Please follow the [common Nuvei instructions](./nuvei) to get set up with Nuvei.

After you set up your Nuvei account, configure the following settings in your merchant account so you can use all features:

* Enable card payments in your account
* Ensure billing country and email address fields are collected during checkout (required by Nuvei)
* Configure webhook endpoints for transaction notifications
* For Apple Pay and Google Pay, ensure pass-through tokens are enabled on your account
* For recurring payments without CVV, contact Nuvei support to enable this feature

### Gated features

The following features are supported but may need to be enabled on the Nuvei account:

* **Apple Pay and Google Pay pass-through** - The ability for decrypted tokens to be passed through to Nuvei is required
* **Recurring payments without CVV** - By default Nuvei does not support a card on file payment with a Nuvei token without a CVV. Contact Nuvei support to enable this feature

## Features

Nuvei supports the following features:

* **Delayed capture** - Authorize a payment and capture it at a later time
* **Partial capture** - Capture a portion of the authorized amount
* **Over-capture** - Capture more than the originally authorized amount
* **Partial authorization** - Authorize only a portion of the requested amount
* **Refunds** - Refund transactions in full or in part
* **Void** - Cancel an authorized transaction before capture
* **Zero auth** - Verify a card without charging it
* **Digital wallets** - Support for Apple Pay, Google Pay, and other digital wallet integrations
* **Network tokens** - Using network-level tokenization for enhanced security and approval rates
* **3-D Secure** - Support for 3DS authentication
* **Settlement reporting** - Detailed settlement and reporting capabilities

## Supported countries

Nuvei supports transactions from buyers in the following countries:

| Country code | Country code | Country code | Country code | Country code | Country code | Country code | Country code |
| ------------ | ------------ | ------------ | ------------ | ------------ | ------------ | ------------ | ------------ |
| `AD`         | `AE`         | `AF`         | `AG`         | `AI`         | `AL`         | `AM`         | `AO`         |
| `AQ`         | `AR`         | `AS`         | `AT`         | `AU`         | `AW`         | `AX`         | `AZ`         |
| `BA`         | `BB`         | `BD`         | `BE`         | `BF`         | `BG`         | `BH`         | `BI`         |
| `BJ`         | `BL`         | `BM`         | `BN`         | `BO`         | `BQ`         | `BR`         | `BS`         |
| `BT`         | `BV`         | `BW`         | `BY`         | `BZ`         | `CA`         | `CC`         | `CD`         |
| `CF`         | `CG`         | `CH`         | `CI`         | `CK`         | `CL`         | `CM`         | `CN`         |
| `CO`         | `CR`         | `CU`         | `CV`         | `CW`         | `CX`         | `CY`         | `CZ`         |
| `DE`         | `DJ`         | `DK`         | `DM`         | `DO`         | `DZ`         | `EC`         | `EE`         |
| `EG`         | `EH`         | `ER`         | `ES`         | `ET`         | `FI`         | `FJ`         | `FK`         |
| `FM`         | `FO`         | `FR`         | `GA`         | `GB`         | `GD`         | `GE`         | `GF`         |
| `GG`         | `GH`         | `GI`         | `GL`         | `GM`         | `GN`         | `GP`         | `GQ`         |
| `GR`         | `GS`         | `GT`         | `GU`         | `GW`         | `GY`         | `HK`         | `HM`         |
| `HN`         | `HR`         | `HT`         | `HU`         | `ID`         | `IE`         | `IL`         | `IM`         |
| `IN`         | `IO`         | `IQ`         | `IR`         | `IS`         | `IT`         | `JE`         | `JM`         |
| `JO`         | `JP`         | `KE`         | `KG`         | `KH`         | `KI`         | `KM`         | `KN`         |
| `KP`         | `KR`         | `KW`         | `KY`         | `KZ`         | `LA`         | `LB`         | `LC`         |
| `LI`         | `LK`         | `LR`         | `LS`         | `LT`         | `LU`         | `LV`         | `LY`         |
| `MA`         | `MC`         | `MD`         | `ME`         | `MF`         | `MG`         | `MH`         | `MK`         |
| `ML`         | `MM`         | `MN`         | `MO`         | `MP`         | `MQ`         | `MR`         | `MS`         |
| `MT`         | `MU`         | `MV`         | `MW`         | `MX`         | `MY`         | `MZ`         | `NA`         |
| `NC`         | `NE`         | `NF`         | `NG`         | `NI`         | `NL`         | `NO`         | `NP`         |
| `NR`         | `NU`         | `NZ`         | `OM`         | `PA`         | `PE`         | `PF`         | `PG`         |
| `PH`         | `PK`         | `PL`         | `PM`         | `PN`         | `PR`         | `PS`         | `PT`         |
| `PW`         | `PY`         | `QA`         | `RE`         | `RO`         | `RS`         | `RU`         | `RW`         |
| `SA`         | `SB`         | `SC`         | `SD`         | `SE`         | `SG`         | `SH`         | `SI`         |
| `SJ`         | `SK`         | `SL`         | `SM`         | `SN`         | `SO`         | `SR`         | `SS`         |
| `ST`         | `SV`         | `SX`         | `SY`         | `SZ`         | `TC`         | `TD`         | `TF`         |
| `TG`         | `TH`         | `TJ`         | `TK`         | `TL`         | `TM`         | `TN`         | `TO`         |
| `TR`         | `TT`         | `TV`         | `TW`         | `TZ`         | `UA`         | `UG`         | `UM`         |
| `US`         | `UY`         | `UZ`         | `VA`         | `VC`         | `VE`         | `VG`         | `VI`         |
| `VN`         | `VU`         | `WF`         | `WS`         | `YE`         | `YT`         | `ZA`         | `ZM`         |
| `ZW`         |              |              |              |              |              |              |              |

## Supported currencies

Nuvei supports processing payments in the following currencies:

| Currency code | Currency code | Currency code | Currency code | Currency code | Currency code | Currency code | Currency code |
| ------------- | ------------- | ------------- | ------------- | ------------- | ------------- | ------------- | ------------- |
| `AED`         | `ALL`         | `AMD`         | `ARS`         | `AUD`         | `AZN`         | `BAM`         | `BDT`         |
| `BHD`         | `BMD`         | `BND`         | `BRL`         | `BYN`         | `CAD`         | `CHF`         | `CLP`         |
| `CNY`         | `COP`         | `CRC`         | `CZK`         | `DKK`         | `DOP`         | `DZD`         | `EGP`         |
| `EUR`         | `GBP`         | `GEL`         | `GHS`         | `GTQ`         | `HKD`         | `HUF`         | `IDR`         |
| `INR`         | `IQD`         | `ISK`         | `JOD`         | `JPY`         | `KES`         | `KGS`         | `KRW`         |
| `KWD`         | `KYD`         | `KZT`         | `LBP`         | `LKR`         | `MAD`         | `MDL`         | `MKD`         |
| `MMK`         | `MNT`         | `MUR`         | `MWK`         | `MXN`         | `MYR`         | `MZN`         | `NAD`         |
| `NGN`         | `NOK`         | `NZD`         | `OMR`         | `PEN`         | `PHP`         | `PKR`         | `PLN`         |
| `PYG`         | `QAR`         | `RON`         | `RSD`         | `RUB`         | `SAR`         | `SEK`         | `SGD`         |
| `SOS`         | `THB`         | `TND`         | `TOP`         | `TRY`         | `TTD`         | `TWD`         | `UAH`         |
| `UGX`         | `USD`         | `UYU`         | `UZS`         | `VND`         | `XAF`         | `XOF`         | `YER`         |
| `ZAR`         |               |               |               |               |               |               |               |

## Limitations

The following features are not supported by this connector:

* **Payment method tokenization** - Storing payment methods through a separate tokenization flow (must tokenize as part of transactions)
* **Installments** - Issuer-based installment plans
* **Idempotency** - Nuvei does not support retrying the same transaction to get the original response
* **Co-badged card routing** - Merchant preferred routing for co-badged cards

## Integration

To accept card payments with Nuvei, use one of Gr4vy's client-side integration methods to securely collect card details. Due to PCI compliance requirements, card data should never be sent directly to your servers.

You can integrate using:

* **[Embed](/guides/payments/embed/quick-start)** - A pre-built, customizable payment form that handles the complete payment flow
* **[Secure Fields](/guides/payments/secure-fields/quick-start)** - Embed card input fields for building custom payment forms while maintaining PCI compliance
* **[Mobile SDKs](/guides/get-started#sdks-and-plugins)** - Native SDKs for iOS, Android, React Native, and other platforms

These methods handle card data collection and tokenization. Once the card details are collected and tokenized, create a transaction through the Gr4vy API, which automatically routes the payment to your configured Nuvei connection based on your Flow rules or explicit `payment_service_id` parameter.

### Recurring payments

The Nuvei card connector can operate as either [an open or a closed-loop](../../guides/features/recurring-payments/open-loop.mdx) connector. In a closed-loop configuration Nuvei tokens are used for every transaction, which means it is not possible to process a subsequent payment with another provider.

In an open-loop situation card data from the vault is used for every transaction, allowing processing of transactions in a recurring payments with a different payment service for every transaction.

By default, the Nuvei connector works in a closed-loop configuration, as Nuvei requires open-loop to be enabled for the account before transactions can be processed that way. Please contact the support team for additional guidance.

## Testing

For testing in sandbox environments, you can use standard test card numbers. Nuvei supports industry-standard test cards for simulating different transaction scenarios:

**Successful transactions:**

* Visa: `4000 0000 0000 0002`
* Mastercard: `5555 5555 5555 4444`
* American Express: `3782 822463 10005`

Use any future expiry date and any 3-digit CVV (4 digits for American Express).

For more test scenarios and additional card numbers, refer to the [Nuvei testing documentation](https://docs.nuvei.com/documentation/integration/testing/test-credit-debit-cards/) or contact your Nuvei representative.