Mass Transit Mastercard Authorization with a Token
Request an authorization with a token.
Endpoint
Test:
POST
https://apitest.visaacceptance.com
/pts/v2/paymentsProduction:
POST
https://api.visaacceptance.com
/pts/v2/paymentsRequired Fields for a Mastercard Authorization with a Token Using the REST
API
- clientReferenceInformation.code
- clientReferenceInformation.partner.solutionId
- The value for this field is provided byVisa Acceptance Solutions.
- clientReferenceInformation.partner.thirdPartyCertificationNumber
- The value for this field is provided byVisa Acceptance Solutions.
- clientReferenceInformation.transactionId
- orderInformation.amountDetails.currency
- orderInformation.amountDetails.totalAmount
- paymentInformation.initiationChannel
- pointOfSaleInformation.catLevel
- Set this field to2.
- pointOfSaleInformation.entryMode
- Set this field tocontactless.
- pointOfSaleInformation.terminalCapability
- Set this field to5.
- pointOfSaleInformation.terminalId
- pointOfSaleInformation.terminalPinCapability
- Set this field to0.
- processingInformation.authorizationOptions.aggregatedAuthIndicator
- Set this field totrue.
- processingInformation.authorizationOptions.authIndicator
- Set this field to0.
- processingInformation.authorizationOptions.deferredAuthIndicator
- Set this field totrue.
- processingInformation.authorizationOptions.transportationMode
- processingInformation.captureOptions.dateToCapture
- processingInformation.commerceIndicator
- Set this field toretail.
- processingInformation.industryDataType
- Set this field totransit.
- tokenInformation.jti
- Generate this value using the UUID2/UUID4 data format.
Example: Performing a Mastercard Authorization with a Token Using the REST
API
Request
{ "clientReferenceInformation": { "code": "10000721", "transactionId": "987654321", "partner": { "thirdPartyCertificationNumber": "BPCDRC220403", "solutionId": "548UHQ8Z" } }, "processingInformation": { "industryDataType": "transit", "processingInformation.commerceIndicator" : "retail", "captureOptions": { "dateToCapture": "0425" }, "authorizationOptions": { "authIndicator": "0", "deferredAuthIndicator": "true", "aggregatedAuthIndicator": "true", "transportationMode": "00" } }, "orderInformation": { "amountDetails": { "totalAmount": "10.00", "currency": "USD" } }, "paymentInformation": { "initiationChannel": "00" }, "tokenInformation": { "jti": "a76392f4-cde4-97aa-1112-0242ac14c005" }, "pointOfSaleInformation": { "terminalId": "12345678", "catLevel": "2", "entryMode": "contactless", "terminalCapability": "5", "terminalPinCapability": "0" } }
Response to a Successful Request
{ "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/64823013154065933040011/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/6482301315406593304011" }, "capture": { "method": "POST", "href": "/pts/v2/payments/6482301315406593304011/captures" } }, "clientReferenceInformation": { "code": "10000721", "partner": { "solutionId": "548UHQ8Z" }, "transactionId": "987654321" }, "id": "6482301315406593304011", "orderInformation": { "amountDetails": { "authorizedAmount": "10.00", "currency": "THB" } }, "paymentAccountInformation": { "card": { "type": "002" } }, "paymentInformation": { "tokenizedCard": { "type": "002" }, "card": { "type": "002" } }, "processorInformation": { "systemTraceAuditNumber": "191316", "approvalCode": "831000", "merchantAdvice": { "code": "01", "codeRaw": "M001" }, "responseDetails": "ABC", "networktransactionId": "016153570198201", "retrievalReferenceNumber": "211511164721", "consumerAuthenticationResponse": { "code": "2", "codeRaw": "2" }, "transactionId": "016153570198201", "responseCode": "00", "avs": { "code": "Y", "codeRaw": "Y" } }, "reconciliationId": "6482301315406593304011", "status": "AUTHORIZED", "submitTimeUtc": "2022-03-25T17:42:11Z" }