Skip to main content
This guide explains how to connect Nuvei as a data source in Payrails. Nuvei delivers your reports to an SFTP folder it hosts for you, Payrails reads them from that folder every day, and you configure the integration yourself in the Payrails portal.

​
Prerequisites

You need:
  • Administrator access to the Nuvei Control Panel for your top-level account
  • The Nuvei SFTP account of your top-level account: host, port, username, and SSH private key. Nuvei creates one SFTP login per top-level account
  • The Payrails IP addresses on the allowlist of that SFTP account (see Step 2)

​
Overview

Payrails ingests two Nuvei reports:
  • Movement: one row per balance movement, such as a sale, credit, chargeback, fee, or payout.
  • Finance Settlement: one row per payout line, summarizing what Nuvei settles to you.
Nuvei generates both reports on a schedule you set in the Control Panel and delivers them to your SFTP folder. One integration instance covers every account under your top-level account.

​
Step-by-step instructions

​
Step 1: Schedule the report distributions

In the Nuvei Control Panel, set up a daily SFTP distribution for each report:
  1. A Movement report distribution. Include the Movement ID and Payout ID columns. Payrails uses Movement ID to identify each row, and Payout ID to link each movement to its payout.
  2. A Finance Settlement report distribution.
If you’re unsure how to set up a distribution, ask your Nuvei account manager.

​
Step 2: Allowlist the Payrails IP addresses

Ask your Payrails account manager for the Payrails IP addresses. Then ask Nuvei Enterprise Support to add them to the allowlist of your SFTP account. Payrails can’t connect to the folder until they do.

​
Step 3: Add the Nuvei integration in the Payrails portal (self-serve)

  1. Log in to the Payrails portal and open Settings → Integrations → Data.
  2. Click Add instance (top-right).
  3. In New instance, select integration type Data, then click Continue.
  4. Select provider: Nuvei, then click Continue.
  5. On the Configure account screen, fill in:
    • Integration instance name: a unique label. Use only letters, numbers, dashes, and underscores.
    • Start Date: the date from which Payrails reads reports. Use today’s date. For earlier data, contact your Payrails account manager.
    • Host, Port, and Username: the details of your Nuvei SFTP account.
    • Private Key: the full SSH private key of your SFTP account, including the BEGIN and END lines. The key must not have a passphrase.
  6. Click Save account. The instance appears in the Data integrations list and Payrails begins ingesting data on the next daily run.

​
Data availability

Payrails reads new report files once a day. Each file shows on the dashboards after the next daily run that follows its delivery. Nuvei delivers the Finance Settlement report two days after the settlement date. The delay of the Movement report depends on the schedule you set in Step 1. Nuvei doesn’t create a file for a day with no data.
Last modified on November 10, 2026