> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://ixopay.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ixopay.ferndocs.com/_mcp/server.

# Nuvei

## Creditcard (Nuvei PCI)

Configure the following parameters for the Connector (see Connector Detail Overview - Nuvei - Vault Configuration):

1. Select the mandatory **Environment** : Live, Sandbox
2. Select the option **Use Safecharge MPI**
3. Fill in the mandatory **Merchant ID**
4. Fill in the mandatory **Merchant Site ID**
5. Fill in the mandatory **Secret Key**
6. Fill in the mandatory **Merchant Url**
7. Enable the option **Enable Account Funding Transactions** to flag transactions as AFT
8. Select the option **Do not send isRebilling flag**
9. Fill in the optional **Amount for Card Registers (Default: 0.01). If greater than zero, an implicit pre-authorize and \[void] will be performed**
10. Select the option **Don't attempt to void the pre-authorization of a register transaction, if the amount is greater than zero.**
11. Select the optional **Default Indicator for Card Registers** — Recurring (INITIAL), Unscheduled (FIRST-CARDONFILE)
12. Enable the option **Dynamic Descriptor** (see Dynamic Descriptor)
13. Fill in the **Prefix descriptor** (see Dynamic Descriptor)

![Connector Detail Overview - Nuvei - Vault Configuration](https://documentation.ixopay.com/manual/assets/ideal-img/connector-detail-overview-nuvei-vault-configuration.d43c34f.1280.png)Connector Detail Overview - Nuvei - Vault Configuration

> **Tip**
>
> Please make sure to set the Connector Config **Extra Data: currencyForCardVerification** to the correct Currency for your Connector in case it differs from the Merchant Default Currency
>
> ![Extra Data: currencyForCardVerification](https://documentation.ixopay.com/manual/assets/ideal-img/currency-for-card-verification.d300e11.1280.png)Extra Data: currencyForCardVerification

## Dynamic (Transaction) Descriptor

A dynamic transaction descriptor provides additional information about a specific payment to help customers locating and recognizing it on bank statements or online banking interfaces.

The descriptor text consists of 2 parts:

* **Prefix** - a static text value up to 12 characters long (minimum 3 characters) that is identical for every transaction.
* followed by **The dynamic value** — provided by the Merchant with the transaction description.

In order to setup Dynamic Descriptors raise a support ticket in the Nuvei dashboard to request that this feature be enabled for your Terminal IDs.

Once enabled configure your Connector by enabling **Dynamic descriptor** and entering a **Prefix descriptor**. For all Transaction processed by this Connector, the IXOPAY platform will concatenate the entered **Prefix Descriptor** with the **transaction description.**

> **Note**
>
> Please note that the **total length** of the dynamic descriptor must not exceed 22 characters. The IXOPAY platform will strip off all subsequent characters automatically. The Prefix Descriptor can have a length of minimum 3 characters and a maximum of 12 characters.

## DCC Setup

In order to use the Nuvei Dynamic Currency Conversion, the DCC setup must be configured for the Nuvei PCI connector.

Configure the following parameters to enable Dynamic Currency Conversion (DCC) for the Connector (see Connector Config - DCC Setup):

1. Navigate to the **DCC Setup** Tab
2. Select **NuveiPCI** from the dropdown
3. Click **Connect**
4. Fill in the mandatory **Merchant ID**
5. Fill in the mandatory **Merchant Site ID**
6. Fill in the mandatory **Merchant Secret Key**

![Connector Config - DCC Setup](https://documentation.ixopay.com/manual/assets/ideal-img/connector-config-dcc-setup.b17e979.1280.png)Connector Config - DCC Setup![DCC Configuration](https://documentation.ixopay.com/manual/assets/ideal-img/dcc-configuration.4bd08c7.1280.png)DCC Configuration

## Nuvei APM

The Nuvei APMs can be found inIXOPAY platform selecting the Safecharge adapter. Configure the following parameters for the Connector (see Nuvei APM - Connector Config):

1. Fill in the optional **Username**
2. Fill in the optional **Password**
3. Fill in the optional **API Secret**
4. Select the optional **Extra Data: treatAcceptedAsSuccess** — true, false: In case transactions with callback accepted should be changed to "success" instead of "pending"
5. Fill in the mandatory **Extra Data: merchantID**
6. Fill in the mandatory **Extra Data: merchantSiteID**
7. Fill in the mandatory **Extra Data: merchantSecretKey**

![Nuvei APM - Connector Config](https://documentation.ixopay.com/manual/assets/ideal-img/nuvei-apm-connector-config.ce61c15.1280.png)Nuvei APM - Connector Config

## POS

Configure the following parameters for the Connector (see Connector Config):

1. Fill in the mandatory **TPN** — Terminal Number, to be provided by Nuvei
2. Fill in the mandatory **Token**
3. Fill in the mandatory **AuthKey**
4. Select the mandatory **Extra Data: currency** — USD, CAD
5. Select the optional **Extra Data: defaultPaymentType** — Card, Debit, Credit
6. Fill in the optional **Extra Data: printReceipt** — Yes - Both merchant and customer copies, Yes - Merchant copy only, Yes - Customer copy only, No - receipt wont be printed on terminal
7. Fill in the optional **Extra Data: getReceipt**

![Connector Config](https://documentation.ixopay.com/manual/assets/ideal-img/connector-config.41f5b5c.1280.png)Connector Config

The additional options:

1. Select the optional **Extra Data: ecomEnv**
2. Fill in the optional **Extra Data: ecomMerchantID**
3. Fill in the optional **Extra Data: ecomMerchantSiteID**
4. Fill in the optional **Extra Data: ecomMerchantSecretKey**

Are not relevant for clients using the Adapter. For further information see also the adapter-specific API Documentation: [Nuvei POS](https://documentation.ixopay.com/adapters/nuvei-pos)

Further the Terminal Configuration for this adapter is needed:

1. Navigate in the Tab **Terminals**
2. Select **+ Terminal** to create a new Terminal for this Connector (see New Terminal)
3. Fill in the Configuration Parameters (see New Terminal Configuration)
   1. **Terminal ID** with the parameter invNum
   2. **System Trace Audit Number** — default 0
   3. **Capture Reference** - default 0
4. Activate the switch to **Enable** the Terminal
5. Click **+ Create**

![Connector Detail Overview - Nuvei - Terminals](https://documentation.ixopay.com/manual/assets/ideal-img/connector-detail-overview-nuvei-terminals.6c0d933.1280.png)Connector Detail Overview - Nuvei - Terminals![New Terminal](https://documentation.ixopay.com/manual/assets/ideal-img/new-terminal.6a431ed.1280.png)New Terminal![New Terminal Configuration](https://documentation.ixopay.com/manual/assets/ideal-img/new-terminal-configuration.e234b79.952.png)New Terminal Configuration

> **Note**
>
> Keep in mind, that the **System Trace Audit Number** must be unique among all connectors using the same provider account for every transaction.

## Nuvei POS and Nuvei PCI

In order to be able to use both Nuvei POS and Nuvei PCI in combination (e.g. recurring transactions with Nuvei PCI with initial transaction vie Nuvei POS) a view additional configuration steps are necessary:

In the Nuvei POS

1. Select the Connector Setting **Registration Sharing: Connector GUIDs**
   1. Insert the Connector GUIDs (comma separated) of the Nuvei PCI Connectors, that should be able to initiate transactions using Register Transactions processed by the Nuvei POS Adapter.

![Connector Setting](https://documentation.ixopay.com/manual/assets/ideal-img/connector-setting.9230b4d.834.png)Connector Setting

In the Nuvei PCI Configuration:

1. Enable the Option **Enable Passthrough Tokens** (see Connector Detail Overview - Nuvei - Vault Configuration)
2. Select **mergeCustomerDataFromRef** to True (see Connector Detail Overview - Nuvei - Configuration)

![Connector Detail Overview - Nuvei - Vault Configuration](https://documentation.ixopay.com/manual/assets/ideal-img/connector-detail-overview-nuvei-vault-configuration2.043f7f2.1280.png)Connector Detail Overview - Nuvei - Vault Configuration![Connector Detail Overview - Nuvei - Configuration](https://documentation.ixopay.com/manual/assets/ideal-img/connector-detail-overview-nuvei-configuration.029d75b.1280.png)Connector Detail Overview - Nuvei - Configuration

## Data Fetcher Configuration

You have the option to configure Data Fetchers (see section Enable and Set Up Reconciliation on the [Provider Level](https://documentation.ixopay.com/manual/docs/post-processing/provider)) either on Provider or on Connector Level, depending on which setup works better for your provider.

### Reconciliation & Provider Settlement

The data fetcher configuration for both, reconciliation and provider settlements, is the same. Configure the following Parameters to fetch Reconciliation and Provider Settlement files (transaction\_report format) via SFTP (see Reconciliation Data Fetcher Provider Level):

1. Fill in the optional **Name** for the Data Fetcher
2. Fill in the expected **Interval** in which the Reconciliation / Provider Settlement File should be fetched - days, hours
3. Select the Adapter **NuveiPci**
4. **Test Mode** : this setting is irrelevant for this adapter because there is no production nor test endpoint as the files are always fetched from the given SFTP.
5. Fill in the mandatory **Extra Data:** **sftpHost** used to connect to the SFTP server
6. Fill in the mandatory **Extra Data:** **sftpPort** used to connect to the SFTP server
7. Fill in the mandatory **Extra Data:** **sftpUsername** used to connect to the SFTP server
8. Fill in the mandatory **Extra Data:** **sftpPassword** used to connect to the SFTP server
9. Fill in the optional **Extra Data:** **sftpRootDir** used to specify the directory where the files are deposited.
10. Fill in the optional **Extra Data:** **regex** used to specify the file pattern
11. Fill in the optional **Extra Data:** **privateKey** can be used to authenticate to the SFTP server. The key must be base64 encoded
12. Fill in the optional **Extra Data:** **passphrase** used in combination with the private key should the key be secured with a passphrase

![Reconciliation Data Fetcher Provider Level](https://documentation.ixopay.com/manual/assets/ideal-img/reconciliation-data-fetcher-provider-level.0b3d463.818.png)Reconciliation Data Fetcher Provider Level