Authorizations Using Merchant Decryption for Mastercard

This section provides the information you need in order to process an authorization using merchant decryption for Mastercard.

Required Fields for Authorizing a Payment Using Merchant Decryption for Mastercard

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.ecommerceIndicator: Set this field to
internet
.
consumerAuthenticationInformation.ucafAuthenticationData: Set this field to the network token cryptogram.
consumerAuthenticationInformation.ucafCollectionIndicator: Set this field to
2
.
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 to
1
.
processingInformation.paymentSolution: Set this field to
001
.

Related Information

API Field Reference for the REST API

REST Example: Merchant Decryption and Mastercard

Request

1234567891011121314151617181920212223242526272829303132333435363738
{"clientReferenceInformation": {
        "code": "1234567890"
    },
    "processingInformation": {
        "paymentSolution": "001",
        "commerceIndicator": "spa"
    },
    "paymentInformation": {
       "tokenizedCard": {
            "number": "5432543254325432",
            "expirationMonth": "12",
            "expirationYear": "2031",
            "cryptogram": "ABCDEFabcdefABCDEFabcdef0987654321234567",
            
            "transactionType": "1",
            "type": "002"
        }
    },
    "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": {
        "ucafAuthenticationData": "ABCDEFabcdefABCDEFabcdef0987654321234567",
        "ucafCollectionIndicator": "2"
    }}

Response to a Successful Request

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455
{"_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": "543254",
            "expirationMonth": "12",
            "suffix": "5432",
            "type": "002"
        },
        "card": {
            "type": "002"
        }
    },
    "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"}