Skip to main content

Authorization Reversals

This section provides the information about how to process an authorization reversal. All supported card types can process authorization reversals.

Supported Processors

  • AIBMS
  • American Express Direct
  • Barclays
  • Chase Paymentech Solutions
  • Chase Tandem
  • China UnionPay
  • Cielo
  • Comercio Latino
  • Credit Mutuel-CIC
  • eftpos
  • Elavon Americas
  • FDC Compass
  • FDC Nashville Global
  • FDI Australia
  • FDMS Nashville
  • Getnet
  • GPN
  • HBOS
  • HSBC
  • JCN Gateway
  • Lloyds-OmniPay
  • LloydsTSB Cardnet
  • Moneris
  • National Payment Gateway
  • OmniPay Direct
  • Prosa
  • Rede
  • SIX
  • Streamline
  • TSYS Acquiring Solutions
  • Vero
  • Worldpay VAP
  • Barclays
  • TSYS Acquiring Solutions
  • GPX
  • Chase Paymentech Solutions
  • Elavon Americas
  • FDC Nashville Global
  • Streamline
  • Worldpay VAP

Processor-Specific Information

National Payment Gateway: the authorization reversal is sometimes referred to as a pre-authorization void. National Payment Gateway supports full and partial reversals. Reversing an authorization releases the hold on the customer's payment card funds that the issuing bank placed when processing the authorization. For a debit card or prepaid card in which only a partial amount was approved, the amount of the reversal must be the amount that was authorized, not the amount that was requested.

China UnionPay: use the authorization reversal service to reverse pre-authorizations.

Endpoints

POST /pts/v2/payments/{id}/reversals

POST /pts/v2/payments/{id}/reversals

POST /pts/v2/payments/{id}/reversals

The {id} is the transaction ID returned in the authorization response.

For National Payment Gateway, the endpoint uses a separate base URL. Production: POST https://api.sa.cybersource.com/pts/v2/payments/{id}/reversals. Test: POST https://apitest.sa.cybersource.com/pts/v2/payments/{id}/reversals.

Example

Standard Example

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

National Payment Gateway Example

{    "reversalInformation": {        "amountDetails": {            "totalAmount": "100.00"        }    }}
{    "processorInformation": {        "paymentAccountReferenceNumber": "QHD47E209drPQ9yJD9ddnaFZuSUXu",        "approvalCode": "830SPG",        "retrievalReferenceNumber": "424009035280",        "responseCode": "00",        "settlementDate": "220915"    },    "reversalAmountDetails": {        "currency": "SAR",        "reversedAmount": "100.00"    },    "clientReferenceInformation": {        "code": "TC_SPG_REQUEST_PB-64"    },    "consumerAuthenticationInformation": {        "token": "7247516416161234567890"    },    "reconciliationId": "7247516248131234567890",    "status": "REVERSED",    "id": "7247516416161234567890",    "submitTimeUtc": "2024-08-27T09:40:42Z"}

Required Fields

These fields are required to submit an authorization reversal request.

Default Required Fields

FieldDescription
clientReferenceInformation.codeOrder reference or tracking number. Provide a unique value for each transaction so that you can perform meaningful searches for the transaction.
reversalInformation.amountDetails.currency—
reversalInformation.amountDetails.totalAmountThe 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.

Processor-Specific Required Field

FieldDescription
clientReferenceInformation.partner.thirdPartyCertificationNumber provides the value for this field.

Last published: September 29, 2026