Skip to main content

Nuvei PCI

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 MethodTransaction FlowsTransaction Types
CreditcardiFrame Form & payment.js IntegrationDebit, Register, Preauthorize, Capture, Void, Refund, Deregister

Mandatory Parameters​

FieldRequired
customer.firstNametrue
customer.lastNametrue
customer.emailtrue
customer.billingCountrytrue
customer.ipAddresstrue

Mapping to Nuvei​

Gateway ParameterAdapter parameterRequiredDescription
merchantTransactionIdcustomDatatrueAdding 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

FieldRequired
customer.shippingFirstNametrue
customer.shippingLastNametrue

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 parameterNuvei parameterTypeDescription
extraData.account_name_inquirycardHolderNameVerificationstringNormalized 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_detailscardHolderNameVerificationstringNuvei'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.