Timeout Authorization Reversal {#payments-timeout-auth-reversals-intro}
=======================================================================

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](/docs/cybs/en-us/payments/developer/ctv/rest/payments/payments-intro/timeouts-intro.md "")  
> 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.cybersource.com``/pts/v2/reversals`  
Test: `POST ``https://apitest.cybersource.com``/pts/v2/reversals`

Required Fields for a Timeout Authorization Reversal {#payments-timeout-auth-reversal-required-fields}
======================================================================================================

[clientReferenceInformation.transactionId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-transaction-id.md "")
:
Identifier that links the reversal request to the original request.

[reversalInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/reversal-info-aa/reversal-info-amount-details-currency.md "")
:

[reversalInformation.amountDetails. totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/reversal-info-aa/reversal-info-amount-details-total-amount.md "")
:
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 {#payments-timeout-auth-reversal-ex-rest}
======================================================================================

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"
}=
```

