This page provides an overview of the payments methods provided by the Nuvei PCI adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating Nuvei PCI 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 |
|---|
| Creditcard | iFrame Form & payment.js Integration | Debit, Register, Preauthorize, Capture, Void, Refund, Deregister |
Mandatory Parameters
| Field | Required |
|---|
| customer.firstName | true |
| customer.lastName | true |
| customer.email | true |
| customer.billingCountry | true |
| customer.ipAddress | true |
Mapping to Nuvei
| Gateway Parameter | Adapter parameter | Required | Description |
|---|
| merchantTransactionId | customData | true | Adding your unique identifier as custom data to be reflected in Reports created in the Nuvei Dashboard. |
VISA AFT Parameters
To enable VISA AFT both fields mentioned below are necessary.
Additionally, it's required to set up a dedicated connector for the AFT transactions and check "Enable Account Funding Transactions" checkbox in the connector Vault Setup
| Field | Required |
|---|
| customer.shippingFirstName | true |
| customer.shippingLastName | true |
Account Name Inquiry
Nuvei can verify the cardholder name against the issuing bank (Cardholder Name Verification) on Register transactions.
To enable it, check "Enable Account Name Inquiry" in the connector Vault Setup. The feature has to be enabled by the Nuvei Integration Team as well, and Nuvei may charge a fee per check.
- Only Register transactions with a zero amount are verified: set "Amount for Card Registers" in the connector Vault Setup to
0 (the default is 0.01).
- Visa and Mastercard only. Other card schemes return
not_supported.
customer.firstName and customer.lastName are sent for the verification. If one of them is missing, no inquiry is sent and the result is not_performed.
- The result never changes the outcome of the Register transaction.
Response Mapping
| Gateway parameter | Nuvei parameter | Type | Description |
|---|
extraData.account_name_inquiry | cardHolderNameVerification | string | Normalized Account Name Inquiry result: match, partial_match, no_match, not_performed, not_supported or unverified (Nuvei only: the issuer did not verify the name). Only returned for Register transactions when Account Name Inquiry is enabled. |
extraData.account_name_inquiry_details | cardHolderNameVerification | string | Nuvei's raw name verification results, json encoded: status (nameVerificationRequestResult) and result with fullName, firstName, middleName and lastName where provided. Only returned together with extraData.account_name_inquiry. |