Authorizations Using Merchant Decryption for mada
This section provides the information you need in order to process an authorization using
merchant decryption for mada debit cards and mada prepaid cards issued in the Kingdom of Saudi Arabia.
Apple Pay transactions on these cards are supported on the mada Pay mobile app and for
Visa Platform Connect
only.
Required Fields for Authorizing a Payment Using Merchant Decryption for mada
-
clientReferenceInformation.code
-
consumerAuthenticationInformation.cavv
-
Set this field to the network token cryptogram.
-
consumerAuthenticationInformation.ecommerceIndicator
-
This value should reflect the e-commerce indicator (ECI) value returned 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.card.cardType
-
Set this field to060.
-
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.requestorId
-
Set this field to your token requestor id.
-
Required forVisa Platform Connect.
-
paymentInformation.tokenizedCard.transactionType
-
Set this field to1.
-
processingInformation.paymentSolution
-
Set this field to001.
Related Information
REST Example: Merchant Decryption and mada
Request
{ "clientReferenceInformation": { "code": "1234567890" }, "processingInformation": { "paymentSolution": "001", "commerceIndicator": "internet" }, "paymentInformation": { "card": { "cardType": "060" }, "tokenizedCard": { "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2031", "cryptogram": "AceY+igABPs3jdwNaDg3MAACAAA=", "transactionType": "1" "type": "060", "requestorId": "987654321plokijuhygtfrdeswa" } }, "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": "[email protected]" } }, "consumerAuthenticationInformation": { "cavv": "AceY+igABPs3jdwNaDg3MAACAAA=" } }
Response to a Successful Request
{ "_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", "requestorId": "987654321plokijuhygtfrdeswa", "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" }