FILTER BY TAG

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
You are responsible for complying with the processor’s specific requirements for full authorization reversals. Contact the processor for more information.
Enhanced authorization reversals are supported on this processor; therefore, extra data is included in the authorization reversal request. It is not necessary to process or monitor the extra data.
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
.

Reversing an Authorization

  1. Send the service request to
    POST https://<
    url_prefix
    >/v2/payments/{id}/reversals
    . Use one of these prefixes:
    • Test:
    • Production:

    ADDITIONAL INFORMATION

    Where
    id
    is the authorization ID returned in the authorization response.
    { "id": "6481692924466004003001" }
    The URL with the
    id
    value is included in the authorization response:
    {     "_links": {         "authReversal": {             "method": "POST",             "href": "/pts/v2/payments/6481692924466004003001/reversals"         },
  2. 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 .

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." } }