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

# Nuvei Configuration

| Payment Provider | Geographies | Currencies | Payment Methods | Retain Support | Automatic Chargeback Feed | Account Updater | API Version | Microservice? |
| - | - | - | - | - | - | - | - | - |
| Nuvei Payment Provider | [Supported Countries List](https://nuvei.com/features/card-acquiring/) | [Supported Currencies List](https://nuvei.com/features/card-acquiring/) | \*\*Credit/Debit Cards -\*\**Yes* **SEPA DD**- *No* **Tokenized Credit Card**- *Yes* **Hosted Pages** - *No* **Alternative Payments** - *No* **Digital Wallets** - *No* | **Tokenized Credit Card** - *Yes* **Detokenize PAN** - *No* **Detokenize BIN**- *No* **Partial Auth** - *Yes* **Forced Deposit** - *No* | No | **Retain** - Tokens are automatically updated by Nuvei **Subscribe** - Not Supported | V1 | Yes |

## Required Merchant Information

\[<img src="https://mintcdn.com/amdocs-slm/ifa3y22T11JlqvtT/portal/vindiciaSubscribeAndNewRetain/subscribePaymentProviderIntegration/images/download_button.png?fit=max&auto=format&n=ifa3y22T11JlqvtT&q=85&s=74864737190e56d2ac71f7232f0900ac" alt="" width="150" height="38" data-path="portal/vindiciaSubscribeAndNewRetain/subscribePaymentProviderIntegration/images/download_button.png" />

]\(../images/Nuvei.xlsx)

| Name | Expected Value | Value | Description |
| - | - | - | - |
| Nuvei:merchantId | | | Merchant ID, generated by provider |
| Nuvei:Secret\_key | | | API key for merchant, generated by provider |
| Nuvei:merchantSiteId | | | |
| Does provider need to whitelist IPs | No | | |
| Does merchant need to grant access to Vindicia | No | | |
| Chargeback feed | No | | |
| Account Updater | **Retain** - Tokens are automatically updated by Nuvei **Subscribe** - Not Supported | | |

## Desired Merchant Configuration

(No optional merchant config for Nuvei)

| Name | Value | Comments |
| - | - | - |
| N/A | N/A |   |

* **[Nuvei Merchant Setup Instructions](../topics/nuveiConfiguration_r#)**

* **[Nuvei Detailed Information on Integration](../topics/nuveiConfiguration_r#)**

**Parent topic:**[Payment Provider Specific Configuration](../topics/PaymentProvidersSpecificConfiguration)

## Nuvei Merchant Setup Instructions

The following Instructions are written for Vindicia CTS and services delivery staff.

To configure a merchant to use Nuvei payment provider:

### Merchant Payment Providers

1. In Subscribe Portal 1.0, using you’re admin account, go to **Admin** > **Merchant Configurations**.
2. Select the relevant **Merchant** from the drop-down list.
3. Click **Edit Merchant Configurations**.
4. Enter the **Jira Ticket #** for configuring your merchant payment setup.
5. Add Nuvei to **Merchant Payment Providers**:

   | Payment Provider Name | Account Number | PP Type | Active |
   | - | - | - | - |
   | Nuvei (1083) | \<blank> | BRD(1) | 1 |

   1. Select **Nuvei (1083)** as the payment provider and click **ADD**.
   2. Leave **Account Number** blank.
   3. Set **PP Type** as **BRD**.
   4. Set **Active** to **1**.

### Routing Rule

1. Add a **Routing Rule** for CyberSource.

   | Ordinal | Payment Provider | Value | Rule Method | Active |
   | - | - | - | - | - |
   | 1 | Nuvei (1083) |   | default\_method(1) | 1 |

   1. Select **Nuvei (1083)** as the payment provider and click **ADD**.
   2. Add an **Ordinal** value of **1**.
   3. Leave **Value** blank.
   4. Add a **Rule Method** value of **default\_method(1)**.
   5. Set **Active** to **1**.

      **Note:** If the test payment provider is configured, set its **Active** value to **0**.

**Note:** If a merchant account is set up with several payment providers, the payment provider with highest **Ordinal** value has priority. If routing will be shared amongst payment providers, see [Configuration Method - Payment Providers Routing Rules](routingRulesAbout) for examples of possible configurations.

### Name/Value Pairs

Add the required configuration details in **Name/Value Pairs** for the Nuvei configuration.

| Name | Value |
| - | - |
| Nuvei:merchantId |   |
| Nuvei:Secret\_key |   |
| Nuvei:merchantSiteId |   |

**Parent topic:**[Nuvei Configuration](../topics/nuveiConfiguration_r#)

## Nuvei Detailed Information on Integration

Vindicia supports the following Payment Operations for Nuvei:

| Payment Operation | Yes/No | Notes |
| - | - | - |
| **Standard Implementation Features** | | |
| Verification (no Auth) | No | |
| Minimal Authorization (\$0) policies, by card type) | No | |
| AVS check with standard result mapping | No | |
| CVV/CVN check with standard result mapping | No | |
| Support real-time authorization (stand-alone Auth) | Yes | /Payment – transaction type Auth |
| Void | Yes | /VoidTransaction API |
| Cancel/reverse authorization | Yes | Same as Void |
| Conditional deposit (auth and capture combination) | Yes | /Payment Transaction type –Sale capture = settle |
| Capture (stand-alone capture) | Yes | /SettleTansaction – relatedTransaction id which is already auth. |
| One-time transactions (real-time) | No | |
| Recurring transactions (flagged recurring) | Yes | /Payment – isRebilling 0 – first Recurring Transaction 1 – Recurring |
| Refunds - Full | Yes | /refundTransaction |
| Refunds - Partial | Yes | /refundTransaction |
| 3DS | No | |
| CITMIT/Card On File | Yes | Payment API- need to provide original trx id(implemented only for MIT\_R) |
| Map error/response/result codes to standard actions (Success/Decline/Reject) | Yes | [https://docs.nuvei.com/documentation/guides/response-handling/](https://docs.nuvei.com/documentation/guides/response-handling/) |
| **Special Implementation Features** | | |
| Implemented via Payments Microservice | Yes | |
| Retrieve and store paymentProcessorTransactionId | Yes | Nuvei Transaction ID |
| Retrieve and store Extended Card/Auth Attributes | No | |
| Support tokenization (for Retain) | Yes | |
| Support BIN/Last-4/Expiry Retrieval from external Token | No | Nuvei return the bin details but there is no call specific to return BIN. |
| Support detokenization (Subscribe retrieves full PAN/CC details | No | |
| Support Card Type identification (from BIN or API) | No | |
| Support Visa/general "Stored Credential" flags | Yes | Supported by Nuvei tokenization |
| Account Updater/Amex Card refresher | Yes | |
| Automated/manual chargeback feed | No | |
| **Retain Support** | | |
| Support token as payment method | Yes | userTokenId is required to generate User token in |
| Support detokenization to full PAN | No | |
| Support detokenization to get BIN | No | |
| Support Partial Authorization | Yes | |
| Support Balance Retrieval | No | |
| Support Forced Deposit | No | |

### Payment Provider Documentation

Link to [Nuvei documentation](https://docs.nuvei.com/documentation/online-payments-docs/introduction/).

**Parent topic:**[Nuvei Configuration](../topics/nuveiConfiguration_r#)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.