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

# Nuvei

This page provides an overview of the payments methods provided by the Nuvei adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating Nuvei within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

## Payment Methods

| Payment Method    | Transaction Flows  | Transaction Types            |
| ----------------- | ------------------ | ---------------------------- |
| AliPay            | Full-Page Redirect | Debit only                   |
| FastBankTransfer  | Full-Page Redirect | Debit only                   |
| Giropay           | Full-Page Redirect | Debit only                   |
| iDeal             | Full-Page Redirect | Debit only                   |
| Mistercash        | Full-Page Redirect | Debit only                   |
| Qiwi              | Full-Page Redirect | Debit only                   |
| Sofort            | Full-Page Redirect | Debit only                   |
| UnionPay          | Full-Page Redirect | Debit only                   |
| WeChatPay         | Full-Page Redirect | Debit only                   |
| PSE               | Full-Page Redirect | Debit only                   |
| AlipayPlusUnified | Full-Page Redirect | Debit and Refund only        |
| RakutenPay        | Full-Page Redirect | Debit and Refund only        |
| Nequi             | Full-Page Redirect | Debit,Refund and Payout only |

## Mandatory Parameters

| Field                   | Required |
| ----------------------- | -------- |
| customer.email          | **true** |
| customer.billingCountry | **true** |

### Additional Parameters for payment method PSE

| Gateway parameter           | PSP parameter                                                    | Type                    | Description                                                                                                                        |
| --------------------------- | ---------------------------------------------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `extraData.paymentUserName` | `paymentOption.alternativePaymentMethod.paymentez_userName`      | optional `string`       | Customer's Full name - concatination of `customer.firstName` + space + `customer.lastName`                                         |
| `extraData.userType`        | `paymentOption.alternativePaymentMethod.paymentez_userType`      | **mandatory** `string`  | Customer type (“N” for persona natural, “J” for persona jurídica)                                                                  |
| `extraData.userFisNumber`   | `paymentOption.alternativePaymentMethod.paymentez_userFisNumber` | **mandatory** `string`  | Customer’s document type                                                                                                           |
| `extraData.fiscalNumber`    | `paymentOption.alternativePaymentMethod.paymentez_fiscalNumber`  | **mandatory** `numeric` | Customer’s document number                                                                                                         |
| `extraData.paymentEmail`    | `paymentOption.alternativePaymentMethod.paymentez_email`         | optional `string`       | Customer’s email - `customer.email`                                                                                                |
| `extraData.bankCode`        | `paymentOption.alternativePaymentMethod.paymentez_bankCode`      | optional `numeric`      | The bank code of the selected bank (if this field is not given, static page will be displayed with all the banks in the dropdown.) |
| `customer.identification`   | `userTokenId`                                                    | **mandatory** `string`  | Unique customer identification number                                                                                              |

#### Please check below for the full list of mapped parameters

| Gateway parameter          | PSP parameter              |
| -------------------------- | -------------------------- |
| `customer.firstName`       | `billingAddress.firstName` |
| `customer.lastName`        | `billingAddress.lastName`  |
| `customer.email`           | `billingAddress.email`     |
| `customer.billingAddress1` | `billingAddress.address`   |
| `customer.billingAddress2` | `billingAddress.address2`  |
| `customer.billingPhone`    | `billingAddress.phone`     |
| `customer.billingPostcode` | `billingAddress.zip`       |
| `customer.billingCity`     | `billingAddress.city`      |
| `customer.billingCountry`  | `billingAddress.country`   |
| `customer.billingState`    | `billingAddress.state`     |

### AlipayPlusUnified

### Connector configuration

| Parameter / Name | Type   | Required | Description                                    |
| ---------------- | ------ | -------- | ---------------------------------------------- |
| merchantId       | string | true     | The AlipayPlusUnified / Nuvei Merchant Id      |
| merchantSiteId   | string | true     | The AlipayPlusUnified / Nuvei Merchant site Id |
| secretKey        | string | true     | The AlipayPlusUnified / Nuvei secret key       |

#### Parameters

## Request mapping

| Gateway Parameter         | AlipayPlusUnified Parameter |
| ------------------------- | --------------------------- |
| `customer.firstName`      | `billingAddress.firstName`  |
| `customer.lastName`       | `billingAddress.lastName`   |
| `customer.email`          | `billingAddress.email`      |
| `customer.billingCountry` | `billingAddress.country`    |
| `customer.getIpAddress`   | `deviceDetails.ipAddress`   |

### Additional Parameters for payment method Nequi

| Gateway parameter                                                   | PSP parameter                                               | Type                   | Description                                  |
| ------------------------------------------------------------------- | ----------------------------------------------------------- | ---------------------- | -------------------------------------------- |
| `customer.billingPhone`                                             | `paymentOption.alternativePaymentMethod.nequi_phone_number` | **mandatory** `number` | Customer Billing Phone number                |
| `extraData.psp.paymentOption.alternativePaymentMethod.nequi_method` | `paymentOption.alternativePaymentMethod.nequi_method`       | **mandatory** `string` | Nequi Payment Method("qr" or "notification") |