On This Page

Authorization Reversal Service

The authorization reversal service is a follow-on service that uses the request ID returned from the previous authorization. An authorization reversal releases the hold that the authorization placed on the customer’s credit card funds. Use this service to reverse an unnecessary or undesired authorization.

Processor-Specific Information About Authorization Reversals
Payment Processor	Authorization Reversal Information
`Elavon`	Card types supported for full authorization reversals: Diners Club, Mastercard, Visa. A full authorization reversal must occur within 24 hours of the authorization.
FDC Germany	You are responsible for complying with the processor’s specific requirements for full authorization reversals. Contact the processor for more information.
FDMS South	Card types supported for full authorization reversals: Visa, Mastercard, Discover, and JCB (US Domestic). For JCB cards, US Domestic means that the currency is USD and your location is the U.S., Puerto Rico, Guam, U.S. Virgin Islands, or Northern Mariana Islands. Full authorization reversals are supported only for transactions that do not go through a currency conversion. Full authorization reversals are supported for the following types of merchants and currencies: Merchants located in the U.S. who authorize, settle, and fund in U.S. dollars. Merchants located in Canada who authorize, settle, and fund in Canadian dollars. Merchants located in Latin America or the Caribbean who authorize, settle, and fund in U.S. dollars. Merchants located in Europe who authorize, settle, and fund in the currency for the country in which the merchant is located.
Software Express	Card types supported for full authorization reversals: Visa, Mastercard.

Required Fields for Reversing an Authorization

The following fields are required when creating an authorization reversal request:

clientReferenceInformation.code
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
processingInformation.paymentSolution: Set to
008
.

Related Information

REST API Field Reference Guide

Reversing an Authorization

Send the service request to

POST https://<url_prefix>/v2/payments/{id}/reversals

. Use one of these prefixes:

Test:

apitest.cybersource.com

Production:

api.cybersource.com

Production in India:

api.in.cybersource.com

ADDITIONAL INFORMATION

Where

is the authorization ID returned in the authorization response.

{
  "id": "6481692924466004003001"
}

The URL with the

value is included in the authorization response:

{
    "_links": {
        "authReversal": {
            "method": "POST",
            "href": "/pts/v2/payments/6481692924466004003001/reversals"
        },

Check the response message to make sure that the request was successful. A 200-level HTTP response code indicates success. For information about response codes, see Transaction Response Codes.

Example: Basic Credit Card Authorization Reversal Using the REST API

Authorization Reversal Request

{
  "clientReferenceInformation": {
    "code": "TC50171_3"
  },
  "reversalInformation": {
    "amountDetails": {
      "totalAmount": "102.21"
    },
    "reason": "exception"
  }
}

Authorization Reversal Response

{
    "submitTimeUtc": "2021-04-22T16:44:03Z",
    "status": "approved",
    "errorInformation": {
        "reason": "EXCEPTION",
        "message": "The request was processed successfully."
    }
}