Tokenize Credit Card payment methods on Worldpay 1.4
To tokenize Credit Card payment methods, use one of the approaches described in this article.
Token field mapping
| Worldpay field | Zuora field |
|---|---|
| paymentTokenId | tokens > tokenId |
| authenticatedShopperId | tokens > secondTokenId |
Approaches to creating tokenized Credit Card payment methods
| Approach | Description | Example |
|---|---|---|
| Use the API operation that supports creating payment methods, such as Create a payment method, to tokenize PAN data |
Pass in the following required card information and set
Tokens are generated and stored in Zuora along with the PAN data. Tokens are used in the subsequent recurring payments. |
{
"cardHolderInfo": {
"cardHolderName": "Amy Lawrence"
},
"cardNumber": "378282246310005",
"cardType": "Visa",
"expirationMonth": "03",
"expirationYear": "2030",
"securityCode": "7377",
"type": "CreditCard",
"tokenize": true
}
|
| Use the API operation that supports creating payment methods, such as Create a payment method, to pass in existing tokens |
Pass in Pass in Pass in the masked card number through Pass in the following required fields:
Tokens are stored in Zuora and used in subsequent payments. |
{
"cardType": "Visa",
"cardMaskNumber": "37828XXXX310005",
"type": "CreditCard",
"tokens": {
"tokenId" : "99171682776484228",
"secondTokenId": "761f4ea3-3610-4d98-ae94-1245fea264f7",
"gatewayType": "Worldpay"
}
}
|
|
Use the API operation that supports creating payment methods, such as Create a payment method, to pass in existing tokens and PAN data
|
Pass in the following required card information:
Pass in Pass in Pass in the masked card number through Tokens are stored in Zuora along with the PAN data. Tokens are used in the subsequent payments. |
{
"accountKey": "8a8d90cd93680d79019368215c85005d",
"cardHolderInfo": {
"cardHolderName": "Amy Lawrence"
},
"cardNumber": "378282246310005",
"cardType": "Visa",
"cardMaskNumber": "37828XXXX310005",
"expirationMonth": "03",
"expirationYear": "2030",
"securityCode": "7377",
"type": "CreditCard",
"tokens": {
"tokenId" : "99171682776484228",
"secondTokenId": "761f4ea3-3610-4d98-ae94-1245fea264f7",
"gatewayType": "Worldpay"
}
}
|
| Tokenize payment methods when processing payments | On the configuration page of your Worldpay 1.4 gateway instance, select Tokenize payment method. With this setting enabled, tokens are generated and stored for Credit Card payment methods when processing payments through UI, API, or Payment Pages 2.0. |
Known Limitation
Currently, Zuora does not support token validation for Worldpay 1.4.