Guides
Go to payrails.com

Nuvei

📘

Who should use this guide

This guide is intended for merchants who:

  • Use Payrails as a chargeback
  • Use Nuvei Disputes

Create and configure a Nuvei integration in Payrails

  1. Log in to the Payrails portal.
  2. Go to Settings → Integrations.
  3. Select Add instance to create a new Nuvei integration configuration.
  4. Select the workspaces where this integration should be available.

About workspaces
Workspaces determine where this integration is available. They let you isolate provider setups by region or business line, or share the same configuration across multiple workspaces.

Step 1: Choose the integration type

  • Select Dispute and continue to the next step.

Step 2: Choose the provider

  • Select Nuvei and continue to the next step.

Step 3: Configure your Nuvei integration

📋

What you’ll need from Nuvei

Before you begin, make sure you have access to:

  • Nuvei site ID
  • Nuvei merchant site ID
  • Nuvei processing entity ID
  • Nuvei API key
  • Nuvei Dispute Rest 2.0 API key

Log in to your Nuvei dashboard to complete this step.

Integration instance name

In Payrails

  • Enter an Instance name for your integration.
A screenshot showing the Payrails integration instance name field.

Merchant Nuvei site ID and merchant site ID

In Nuvei

  • Go to Settings → Business.

  • On the Account details tab, copy the client ID and site ID.

In Payrails

  • Paste the value into the merchant site ID and site ID fields.

Processing entity ID

In Nuvei

  1. With Developer role, locate Settings and select Rest 2.0 API credentials.
  2. Copy the entity ID.

In Payrails

  • Paste the value into the Processing enity field.

API key and Dispute Rest 2.0 API key

🔒

Use a restricted API key to limit access scope and reduce blast radius if the key is compromised.

In Nuvei

  1. With Developer role, locate Settings and select Rest 2.0 API credentials.
  2. Generate the keys API key and Dispute API key.
  3. Copy the generated API key and Dispute API key.

In Payrails

  • Paste the value into the API key and Dispute API key fields.

DMN

🔔

Payrails uses Nuvei DMN to receive asynchronous chargeback status updates.

In Nuvei

  1. Go to Settings → My Account → Events configuration → Client level configuration.
  2. Select the Client.

In Payrails

  • Copy the Notification URL from the Account configuration section.
A screenshot showing the Payrails integration instance name field.

In Nuvei

  1. Configure the destination:

    1. Paste the Payrails Notification URL in Chargebacks events settings

    2. Enable the Chargebacks events settings

Enable the integration

In Payrails

  • Select Save account to enable the integration.

The Enabled status indicates that the Nuvei integration is active.

Your Nuvei integration is now ready to process chargebacks.

Next steps

  1. Run a test payment triggering a chargeback using a Nuvei test card.
  2. Verify that:
    • The dispute appears in Nuvei.
    • The chargeback status updates correctly in Payrails.
  3. Once verified in test mode, repeat the setup in live mode.