Authorizations Using Merchant Decryption for Visa
Worldpay VAPREST API
This section provides the information you need in order to process an authorization using
merchant decryption for Visa.
Required Fields for Authorizing a Payment Using Merchant Decryption for Visa
IMPORTANT
Worldpay VAP
supports 3-D Secure 2.0 with Mastercard transactions. Worldpay VAP
also supports network tokens and digital payments with
Mastercard transactions. However, Worldpay VAP
does not support the 3-D
Secure 2.0 protocol if used with network tokens or digital payment. Cybersource
declines any transaction processed by Worldpay VAP
that uses both 3-D Secure 2.0 and either network tokens or digital payments.- clientReferenceInformation.code
- consumerAuthenticationInformation.cavv
- Set this field to the network token cryptogram.
- consumerAuthenticationInformation.ecommerceIndicator
- Set this field to the ECI value contained in the Apple Pay response payload.
- orderInformation.amountDetails.currency
- orderInformation.amountDetails.totalAmount
- orderInformation.billTo.address1
- orderInformation.billTo.administrativeArea
- orderInformation.billTo.country
- orderInformation.billTo.email
- orderInformation.billTo.firstName
- orderInformation.billTo.lastName
- orderInformation.billTo.locality
- orderInformation.billTo.postalCode
- paymentInformation.tokenizedCard.cryptogram
- Set this field to the network token cryptogram.
- paymentInformation.tokenizedCard.expirationMonth
- Set this field to the value from the payment network token expiration month.
- paymentInformation.tokenizedCard.expirationYear
- Set this field to the value from the payment network token expiration year.
- paymentInformation.tokenizedCard.number
- Set this field to the payment network token value.
- paymentInformation.tokenizedCard.transactionType
- Set this field to1.
- processingInformation.paymentSolution
- Set this field to001.
Related Information
REST Example: Merchant Decryption and Visa
Request
12345678910111213141516171819202122232425262728293031323334353637{"clientReferenceInformation": { "code": "1234567890" }, "processingInformation": { "paymentSolution": "001", "commerceIndicator": "internet" }, "paymentInformation": { "tokenizedCard": { "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2031", "cryptogram": "AceY+igABPs3jdwNaDg3MAACAAA=", "transactionType": "1" "type": "001" } }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" }, "billTo": { "firstName": "Maya", "lastName": "Lee", "address1": "123 Main St", "locality": "SomeCity", "administrativeArea": "CA", "postalCode": "94404", "country": "US", "email": "maya.lee@email.world" } }, "consumerAuthenticationInformation": { "cavv": "AceY+igABPs3jdwNaDg3MAACAAA=" } }
Response to a Successful Request
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657{"_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/6234236182176225003004/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/6234236182176225003004" }, "capture": { "method": "POST", "href": "/pts/v2/payments/6234236182176225003004/captures" } }, "clientReferenceInformation": { "code": "1234567890" }, "id": "6234236182176225003004", "orderInformation": { "amountDetails": { "authorizedAmount": "100.00", "currency": "USD" } }, "paymentInformation": { "tokenizedCard": { "expirationYear": "2031", "prefix": "411111", "expirationMonth": "12", "suffix": "1111", "type": "001" }, "card": { "type": "001" } }, "pointOfSaleInformation": { "terminalId": "111111" }, "processingInformation": { "paymentSolution": "001" }, "processorInformation": { "approvalCode": "888888", "networkTransactionId": "123456789619999", "transactionId": "123456789619999", "responseCode": "100", "avs": { "code": "X", "codeRaw": "I1" } }, "reconciliationId": "75729760OPN67ZFV", "status": "AUTHORIZED", "submitTimeUtc": "2021-06-11T15:00:18Z" }