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
  • Mastercard Transaction Link Identifier (TLID) - Nuvei must enable the TLID on each merchant account, so ask your Nuvei account manager. Until it’s enabled, Nuvei accepts the TLID without an error but doesn’t pass it on to Mastercard

​
Capabilities

​
Supported countries

​
Supported currencies

​
Limitations

  • 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 is not supported.

​
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 - Embed SDKs for iOS, Android, and React Native
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 is an open-loop connector. Card data from the vault is used for every transaction, so a subsequent payment in a recurring series can be processed with a different payment service. Nuvei must allow open-loop processing on your account. Please contact the support team for additional guidance. Gr4vy sends the Mastercard Transaction Link Identifier (TLID) on merchant-initiated payments once Nuvei enables it, as described under gated features.

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