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

# Nuvei

> Accept card payments via Nuvei with PayNext.

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

## Integration Guide

<Steps>
  <Step title="Open Nuvei Merchant Portal">
    Log in to the **Nuvei Merchant Portal** and ensure your merchant account is active.
  </Step>

  <Step title="Collect credentials">
    Obtain the following credentials from Nuvei:

    * **Merchant ID**
    * **Merchant Site ID**
    * **Secret Key**
  </Step>

  <Step title="Add integration in PayNext">
    In **Dashboard → Integrations**, click **Add new integration → Nuvei → Connect**
  </Step>

  <Step title="Enter credentials">
    * **Name**: Label for this connection (e.g., "Nuvei US")
    * **Merchant ID**
    * **Merchant Site ID**
    * **Secret Key**
  </Step>

  <Step title="Save">
    Click **Connect** to complete the integration
  </Step>
</Steps>

## Metadata Mapping

Nuvei supports passing merchant-defined metadata using the `customData` fields in requests. These can be used for reconciliation and tracking.

<Info>
  Some metadata fields may require enablement or configuration on the Nuvei account. Contact Nuvei support if fields are not returned in responses.
</Info>

**Supported Fields:**

| Metadata Key         | Target Field                     | Character Limit | Description                |
| -------------------- | -------------------------------- | --------------- | -------------------------- |
| `dynamic_descriptor` | `dynamicDescriptor.merchantName` | 45              | Dynamic payment descriptor |

**Example Usage:**

```json Update Customer Metadata theme={"system"}
PATCH /customers/:id
{
  "metadata": {
    "dynamic_descriptor": "Example Descriptor"
  }
}
```