Tokenized payment methods through the API
Learn how to store and process Nuvei tokenized credit card payment methods through the payment methods API.
Nuvei tokenization is supported through the payment methods API. To store a tokenized Nuvei payment method in Zuora, create the payment method as CreditCard type and provide the Nuvei token values in the tokens object. Do not use the legacy CreditCardReferenceTransaction payment method type with Nuvei.
If the token has already been validated by Nuvei, you can set skipValidation to true so Zuora stores the payment method without performing another validation call.
For downstream Nuvei payment processing, make sure the billing and cardholder details required by Nuvei are present in the payment flow. The ticket records Nuvei feedback that email, IP address, country, and name on card are mandatory, and that first name and last name must be included in the billing address when using UPO tokens.
Sample payloads
Sample request to create a tokenized Nuvei payment method
POST /v1/payment-methods
{
"type": "CreditCard",
"cardType": "Visa",
"expirationMonth": 10,
"expirationYear": 2030,
"cardMaskNumber": "2469",
"skipValidation": true,
"tokens": {
"gatewayType": "Nuvei",
"tokenId": "4884470121",
"secondTokenId": "4028c4e99h2aa9eb019d1eecf3560092"
},
"cardHolderInfo": {
"cardHolderName": "Harsha Varthan",
"addressLine1": "Normal Street",
"city": "Mumbai",
"state": "Maharashtra",
"country": "India",
"zipCode": "560037"
},
"accountKey": "8ad097ab9d1a0277019d1e850f191745"
}Sample success response
{
"success": true,
"id": "8ad08b429d2b1808019d2e2087ff70df"
}Sample unsupported pattern to avoid
{
"type": "CreditCardReferenceTransaction"
}Do not use this payment method type with Nuvei. Requests using this pattern fail with Nuvei gateway does not support CC Reference Transaction payment method.