Skip to main content
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 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 codeCountry codeCountry codeCountry codeCountry codeCountry code
ADAEAFAGAIAL
AMAOAQARASAT
AUAWAXAZBABB
BDBEBFBGBHBI
BJBLBMBNBOBQ
BRBSBTBVBWBY
BZCACCCDCFCG
CHCICKCLCMCN
COCRCUCVCWCX
CYCZDEDJDKDM
DODZECEEEGEH
ERESETFIFJFK
FMFOFRGAGBGD
GEGFGGGHGIGL
GMGNGPGQGRGS
GTGUGWGYHKHM
HNHRHTHUIDIE
ILIMINIOIQIR
ISITJEJMJOJP
KEKGKHKIKMKN
KPKRKWKYKZLA
LBLCLILKLRLS
LTLULVLYMAMC
MDMEMFMGMHMK
MLMMMNMOMPMQ
MRMSMTMUMVMW
MXMYMZNANCNE
NFNGNINLNONP
NRNUNZOMPAPE
PFPGPHPKPLPM
PNPRPSPTPWPY
QARERORSRURW
SASBSCSDSESG
SHSISJSKSLSM
SNSOSRSSSTSV
SXSYSZTCTDTF
TGTHTJTKTLTM
TNTOTRTTTVTW
TZUAUGUMUSUY
UZVAVCVEVGVI
VNVUWFWSYEYT
ZAZMZW

​
Supported currencies

Nuvei supports processing payments in the following currencies:
Currency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency code
AEDALLAMDARSAUDAZNBAMBDTBGNBHD
BMDBNDBRLBYNCADCHFCLPCNYCOPCRC
CZKDKKDOPDZDEGPEURGBPGELGHSGTQ
HKDHUFIDRINRIQDISKJODJPYKESKGS
KRWKWDKYDKZTLBPLKRMADMDLMKDMMK
MNTMURMWKMXNMYRMZNNADNGNNOKNZD
OMRPENPHPPKRPLNPYGQARRONRSDRUB
SARSEKSGDSOSTHBTNDTOPTRYTTDTWD
UAHUGXUSDUYUUZSVNDXAFXOFYERZAR

​
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 - A pre-built, customizable payment form that handles the complete payment flow
  • Secure Fields - Embed card input fields for building custom payment forms while maintaining PCI compliance
  • Mobile SDKs - 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 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 or contact your Nuvei representative.