On This Page

Refund a Payment

This section describes how to refund a payment. You can refund a settled payment for the full amount or a partial amount by sending a refund request. Multiple partial refund requests are also supported, and the total amount of all of the refund requests must be less than the settled amount.

Requesting a refund requires the sale request ID from the sale response. The sale request ID is in the

requestID

response field.

Endpoints

Set the

apRefundService_run

field to

true

, and send the request to one of these endpoints:

Production:

https://ics2ws.ic3.com/commerce/1.x/transactionProcessor

Test:

https://ics2wstest.ic3.com/commerce/1.x/transactionProcessor

Required Fields for Refunding a Payment

apPaymentType: Set to
MBB
.
apRefundService_refundRequestID: Set to the request ID included in the sale response.
apRefundService_run: Set to
true
.
merchantID
merchantReferenceCode
purchaseTotals_currency: Set to
EUR
.
purchaseTotals_grandTotalAmount

Example: Refunding a Payment

Request

<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.211">
  <merchantID>nrphotography</merchantID>
  <merchantReferenceCode>Refund</merchantReferenceCode>
  <purchaseTotals>
    <currency>EUR</currency>
    <grandTotalAmount>10.00</grandTotalAmount>
  </purchaseTotals>
  <apPaymentType>MBB</apPaymentType>
  <apRefundService run="true">
    <refundRequestID>7478635704886789703607</refundRequestID>
  </apRefundService>
</requestMessage>

Response to a Successful Request

<replyMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.211">
  <merchantReferenceCode>Refund</merchantReferenceCode>
  <requestID>7478637798796676103609</requestID>
  <decision>ACCEPT</decision>
  <reasonCode>100</reasonCode>
  <requestToken>AxjnrwSTlWryznv9JP25ANgZYiy6kGDXhyoLKQnkH8hOI/pCvoUFYZNJMvRjDLC/Scq1da8KzRZD24AAxzUC</requestToken>
  <purchaseTotals>
    <currency>EUR</currency>
  </purchaseTotals>
  <apRefundReply>
    <reasonCode>100</reasonCode>
    <transactionID>973340962485</transactionID>
    <status>REFUNDED</status>
    <processorResponse>00006</processorResponse>
    <amount>10.00</amount>
    <dateTime>2025-05-21T21:43:01Z</dateTime>
    <reconciliationID>XEKTAAWCJA2H</reconciliationID>
    <returnRef>KL9RNANN5WZ7</returnRef>
    <paymentStatus>refunded</paymentStatus>
    <responseCode>00006</responseCode>
  </apRefundReply>
</replyMessage>

Response Statuses for Refunding a Payment

Cybersource responds to your refund request with one of these statuses in the

field:

FAILED

: The refund request failed.

REFUNDED

: The refund request is accepted but is not completed. Send a check status request to verify that the status is refunded. For more information, see Check a Status.