Mass Transit Visa Deferred Sale with a Token

A sale transaction is a bundled authorization and capture. At the end of the travel period, request a Visa deferred sale with a token for an aggregated payment.

Endpoint

Test:

POST https://apitest.visaacceptance.com/pts/v2/payments

Production:

POST https://api.visaacceptance.com/pts/v2/payments

Required Fields for a Visa Deferred Sale with a Token Using the REST API

clientReferenceInformation.partner.thirdPartyCertificationNumber
clientReferenceInformation.transactionId
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
pointOfSaleInformation.catLevel: Set this field to
2
.
pointOfSaleInformation.entryMode: Set this field to
contactless
.
pointOfSaleInformation.terminalCapability: Set this field to
5
.
pointOfSaleInformation.terminalId
pointOfSaleInformation.terminalPinCapability: Set this field to
0
.
processingInformation.authorizationOptions.aggregatedAuthIndicator: Set this field to
true
.
processingInformation.authorizationOptions.deferredAuthIndicator: Set this field to
true
.
processingInformation.capture: Set this field to
true
.
processingInformation.captureOptions.dateToCapture
processingInformation.commerceIndicator: Set this field to
retail
.
processingInformation.industryDataType: Set this field to
transit
.
processingInformation.reconciliationId
tokenInformation.jti

Mass Transit Visa Deferred Sale with a Token

Example: Performing a Visa Deferred Sale with a Token Using the REST API

Request

{
    "clientReferenceInformation": {
        "transactionId": "21987654321",
        "partner": {
            "thirdPartyCertificationNumber": "123456789012"
        }
    },
    "processingInformation": {
        "industryDataType": "transit",
        "reconciliationId": "fgssgsgsgsfg",
        "captureOptions": {
            "dateToCapture": "0325"
        },
        "capture": "true",
        "processingInformation.commerceIndicator" : "retail",
        "authorizationOptions": {
            "deferredAuthIndicator": "true",
            "aggregatedAuthIndicator": "true"
        }
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "300.00",
            "currency": "THB"
        }
    },
    "tokenInformation": {
        "jti": "a76392f4-cde4-97aa-1111-0242ac14c005"
    },
    "pointOfSaleInformation": {
        "terminalId": "12345678",
        "catLevel": "2",
        "entryMode": "contactless",
        "terminalCapability": "5",
        "terminalPinCapability": "0"
    }
}

Response to a Successful Request

{
    "_links": {
        "void": {
            "method": "POST",
            "href": "/pts/v2/payments/6482303624466600104004/voids"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/payments/6482303624466600104004"
        }
    },
    "clientReferenceInformation": {
        "code": "testcode1012",
        "transactionId": "21987654321"
    },
    "id": "6482303624466600104004",
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "300.00",
            "authorizedAmount": "300.00",
            "currency": "THB"
        }
    },
    "paymentAccountInformation": {
        "card": {
            "type": "001"
        }
    },
    "paymentInformation": {
        "tokenizedCard": {
            "type": "001"
        },
        "card": {
            "type": "001"
        }
    },
    "processorInformation": {
        "systemTraceAuditNumber": "191328",
        "approvalCode": "831000",
        "merchantAdvice": {
            "code": "01",
            "codeRaw": "M001"
        },
        "responseDetails": "ABC",
        "networktransactionId": "016153570198200",
        "consumerAuthenticationResponse": {
            "code": "2",
            "codeRaw": "2"
        },
        "transactionId": "016153570198200",
        "responseCode": "00",
        "avs": {
            "code": "Y",
            "codeRaw": "Y"
        }
    },
    "reconciliationId": "fgssgsgsgsfg",
    "status": "AUTHORIZED",
    "submitTimeUtc": "2022-03-25T17:46:02Z"
}

Mass Transit Visa Deferred Sale with a Token