On This Page

Time-Out Void for an Authorization, Authorization Reversal, Capture, or Sale

When you do not receive a response message after requesting an authorization, authorization reversal, capture, or sale, this feature enables you to void the transaction that you requested.
Include the
clientReferenceInformation.transactionId
 field in the original request for an authorization, authorization reversal, capture, or sale. The value of the merchant transaction ID must be unique for 180 days.
When the original transaction fails, the response message for the reversal request includes these fields:
  • voidAmountDetails.originalTransactionAmount
  • processorInformation.responseCode

Endpoint

Production:
POST
https://api.visaacceptance.com
/pts/v2/voids/
Test:
POST
https://apitest.visaacceptance.com
/pts/v2/voids/

Required Fields for a Time-Out Void for an Authorization, Authorization Reversal, or Capture

clientReferenceInformation.code
clientReferenceInformation.reconciliationId
clientReferenceInformation.transactionId
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount

REST Example: Time-Out Void for an Authorization, Authorization Reversal, or Capture

Request
{
  "clientReferenceInformation": {
    "code": "123456789012",
    "reconciliationId": "000000050000772"
    "transactionId": "987654321"
   },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "100",
            "currency": "USD"
        }
    }
}
Response to a Successful Request
{
    "submitTimeUtc": "2025-03-11T16:57:19Z",
    "processorInformation": {
        "approvalCode": "OK1272",
        "responseCode": "000"
    },
    "consumerAuthenticationResponse": {
        "systemTraceAuditNumber": "500039"
    },
    "orderInformation": {
        "amountDetails": {
            "authorizedAmount": "110.00"
        }
    },
    "message": "Successful transaction.",
    "clientReferenceInformation": {
        "code": "123456789012"
    },
    "reconciliationId": "000000050000772",
    "id": "7417122396283232235535",
    "_links": {
        "self": {
            "method": "GET",
            "href": "/pts/v2/voids/7417122396283232235535"
        }
    },
    "status": "VOIDED"
}