Skip to main content
Who should use this guideThis 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 workspacesWorkspaces 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.
Payrails integration type selection set to dispute

​
Step 2: Choose the provider

  • Select Nuvei and continue to the next step.
Payrails provider selection set to Nuvei

​
Step 3: Configure your Nuvei integration

What you’ll need from NuveiBefore 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.
Nuvei 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. Nuvei account details with 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.
Nuvei Rest 2.0 API credentials showing 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.
Nuvei API key and dispute API key generation 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.
Payrails notification URL field for Nuvei DMN In Nuvei
  1. Configure the destination:
    1. Paste the Payrails Notification URL in Chargebacks events settings
    2. Enable the Chargebacks events settings Nuvei events configuration for chargebacks notification

​
Enable the integration

In Payrails
  • Select Save account to enable the integration.
The Enabled status indicates that the Nuvei integration is active. Payrails Nuvei integration enabled status 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.
Last modified on September 29, 2026