Skip to main content
Nuvei is a global payment processor offering card acquiring and alternative payment methods across North America, Europe, and Asia-Pacific, with strong support for advanced payment flows and risk management.

​
Processor Details

Payment MethodsCards Apple Pay Google Pay
Supported CurrenciesMultiple (configured per merchant account)
Metadata Mapping✓
Network Tokens✓
3DS Support✓
3RI Support✗

​
Integration Guide

1

Open Nuvei Merchant Portal

Log in to the Nuvei Merchant Portal and ensure your merchant account is active.
2

Collect credentials

Obtain the following credentials from Nuvei:
  • Merchant ID
  • Merchant Site ID
  • Secret Key
3

Add integration in PayNext

In Dashboard → Integrations, click Add new integration → Nuvei → Connect
4

Enter credentials

  • Name: Label for this connection (e.g., “Nuvei US”)
  • Merchant ID
  • Merchant Site ID
  • Secret Key
5

Save

Click Connect to complete the integration

​
Metadata Mapping

Nuvei supports passing merchant-defined metadata using the customData fields in requests. These can be used for reconciliation and tracking.
Some metadata fields may require enablement or configuration on the Nuvei account. Contact Nuvei support if fields are not returned in responses.
Supported Fields:
Metadata KeyTarget FieldCharacter LimitDescription
dynamic_descriptordynamicDescriptor.merchantName45Dynamic payment descriptor
Example Usage:
Update Customer Metadata
PATCH /customers/:id
{
  "metadata": {
    "dynamic_descriptor": "Example Descriptor"
  }
}