Developer Guide Menu

Merchant-Initiated Reversals and Voids

When you do not receive a reply message after sending a request to CyberSource, this feature enables you to reverse or void the transaction that you requested.
API Resource Name:
POST https://api.cybersource.com/pts/v2/payments
Note
 For merchants in India, the Production endpoint is 
https://api.in.cybersource.com/pts/v2/payments
Ready to integrate?
  1. Include the 
    clientReferenceInformation.transactionId
     field in your original request for an authorization, capture, sale, follow-on credit, or stand-alone credit.

    Step Result

    NOTE

    The value of the merchant transaction ID must be unique for 60 days.
  2. When you do not receive a reply message for your original transaction request, reverse or void the original transaction as described in the following table.

    Step Result

    Transaction to Reverse or Void
    Procedure
    Authorization
    Request the full authorization reversal service as described in "Reversals."Instead of including the request ID in your request message, include the 
    clientReferenceInformation.transactionId
     field. The merchant transaction ID links your reversal request to your original request.
    Capture or sale
    Request the void service as described in "Voids." Instead of including the request ID in your request message, include the 
    clientReferenceInformation.transactionId
     field. The merchant transaction ID links your void request to your original request.CyberSource automatically handles authorization reversals on capture and sale requests.
    Credit
    Request the void service as described in"Voids." Instead of including the request ID in your request message, include the 
    clientReferenceInformation.transactionId
     field. The merchant transaction ID links your void request to your original request.
  3. If the original transaction failed, the reply message for the reversal or void request includes the following fields:
    • reversalAmountDetails.originalTransactionAmount
    • authorizationInformation.reasonCode
Top