Nuvei

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 Methods	Cards Apple Pay Google Pay
Supported Currencies	Multiple (configured per merchant account)
Metadata Mapping	✓
Network Tokens	✓
3DS Support	✓
3RI Support	✗
ARN	✗
Fraud Signals	✗

Integration Guide

Open Nuvei Merchant Portal

Collect credentials

Obtain the following credentials from Nuvei:

Merchant ID
Merchant Site ID
Secret Key

Add integration in PayNext

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

Enter credentials

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

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 Key	Target Field	Character Limit	Description
`dynamic_descriptor`	`dynamicDescriptor.merchantName`	45	Dynamic payment descriptor

Example Usage:

Update Customer Metadata

PATCH /customers/:id
{
  "metadata": {
    "dynamic_descriptor": "Example Descriptor"
  }
}

⌘I

Introduction

Processors

Payment Methods

Tax

Processor Details

Integration Guide

Metadata Mapping

​Processor Details

​Integration Guide

​Metadata Mapping

Processor Details

Integration Guide

Metadata Mapping