Authorizations Using Merchant Decryption for JCB
This section provides the information you need in order to process an authorization using
merchant decryption for JCB.
Required Fields for Authorizing a Payment Using Merchant Decryption for JCB
-
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
Optional Fields for Authorizing a Payment for Apple Pay Transactions
You can include these optional fields in a request for an authorization:
-
paymentInformation.tokenizedCard.assuranceMethod
-
Set this field to the tokenization confidence level specified by the method used to verify the account or authenticate the cardholder. The value is assigned by the token service provider.
Related Information
REST Example: Merchant Decryption and JCB
Request
{ "clientReferenceInformation": { "code": "1234567890" }, "processingInformation": { "paymentSolution": "001" }, "paymentInformation": { "tokenizedCard": { "number": "128945xxxxxx2398", "expirationMonth": "12", "expirationYear": "2031", "cryptogram": "AceY+igABPs3jdwNaDg3MAACAAA=", "transactionType": "1" "type": "003" } }, "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": "128945", "expirationMonth": "12", "suffix": "2398", "type": "003" }, "card": { "type": "003" } }, "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" }