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
Visa Platform Connect
Card types supported for full authorization reversals: American Express, China UnionPay, Diners Club, Discover, JCB, mada, Mastercard, Visa.

Required Fields for Reversing an Authorization

The following fields are required when creating an authorization reversal request:
ccAuthReversalService_authRequestID
Set to the request ID that was included in the authorization reply message.
ccAuthReversalService_run
Set to
true
.
merchantID
merchantReferenceCode
paymentSolution
Set to
008
.
purchaseTotals_currency
purchaseTotals_grandTotalAmount
Either
purchaseTotals_grandTotalAmount
 or
item_#_unitPrice
 must be included in the request.

Reversing an Authorization

  1. Request the service. Set the
    ccAuthReversalService_run
     field to
    true
    , and send the request to one of these endpoints:
    • https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
    • https://ics2wsa.ic3.com/commerce/1.x/transactionProcessor
  2. Check the response message to make sure that the request was successful. A value of
    ACCEPT
     for the
    decision
     field indicates success. For information about reason codes, see Reason Codes for the Simple Order API.

XML Example: Basic Credit Card Authorization Reversal Using the Simple Order API

Authorization Reversal Request
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.121">
    <merchantID>retail_910</merchantID>
    <merchantReferenceCode>MS299131501003</merchantReferenceCode>
    <purchaseTotals>
        <currency>USD</currency>
        <grandTotalAmount>99.49</grandTotalAmount>
    </purchaseTotals>
    <ccAuthReversalService run="true">
        <authRequestID>6152173358406291304007</authRequestID>
    </ccAuthReversalService>
    <paymentSolution>008</paymentSolution>
</requestMessage>
Authorization Reversal Response
<c:replyMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.121">
    <c:merchantReferenceCode>MS299131501003</c:merchantReferenceCode>
    <c:requestID>1019827520348290570293</c:requestID>
    <c:purchaseTotals>
        <c:currency>USD</c:currency>
    </c:purchaseTotals>
    <c:ccAuthReversalReply>
        <c:amount>99.49</c:amount>
        <c:authorizationCode>1</c:authorizationCode>
    </c:ccAuthReversalReply>
</c:replyMessage>