On This Page

Timeout Authorization Reversal

When you do not receive a response message after sending an authorization request, this feature enables you to reverse the authorization that you requested.

IMPORTANT

Wait 60 seconds before requesting a timeout authorization reversal. For guidance on timeout scenarios, see Transaction Timeout Guidance

Include the

clientReferenceInformation.transactionId

field in the original request for an authorization. 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:

reversalAmountDetails.originalTransactionAmount

processorInformation.responseCode

Requirements

Unless your processor supports authorization reversal after void (ARAV), timeout authorization reversals are supported only for authorizations that have not been captured and settled.

Endpoint

Production:

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

Test:

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

Required Fields for a Timeout Authorization Reversal

clientReferenceInformation.transactionId: Identifier that links the reversal request to the original request.
orderInformation.amountDetails.currency
reversalInformation.amountDetails.totalAmount: The amount of the reversal must be the same as the authorization amount that was included in the authorization response message. Do not use the amount that was requested in the authorization request message.
reversalInformation.reason

REST Example: Timeout Authorization Reversal

Request

{
  "clientReferenceInformation": {
    "transactionId": "987654321"
 },
   "reversalInformation": {
     "amountDetails": {
       "totalAmount": "100.00",
       "currency": "ABC"
     },
     "reason": "testing"
  }
}

Response to Successful Request

{
  "_links" : {
    "self" : {
      "method" : "GET",
      "href" : "/pts/v2/reversals/6869460219566537303955"
    }
  },
  "clientReferenceInformation" : {
    "code" : "RTS-Auth-Reversal"
  },
  "id" : "6869460219566537303955",
  "orderInformation" : {
    "amountDetails" : {
      "currency" : "ABC"
    }
  },
  "processorInformation" : {
    "settlementDate": "0501",
    "responseCode" : "200"
  },
  "reconciliationId" : "82kBK3qDNtls",
  "reversalAmountDetails" : {
    "reversedAmount" : "100.00",
    "currency" : "ABC"
  },
  "status" : "REVERSED",
  "submitTimeUtc" : "2026-06-16T20:07:02Z"
}=