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
SDX
.
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>test-merchant</merchantID>
	<merchantReferenceCode>Sodexo-Refund</merchantReferenceCode>
	<purchaseTotals>
		<currency>EUR</currency>
		<grandTotalAmount>1.00</grandTotalAmount>
	</purchaseTotals>
	<apPaymentType>SDX</apPaymentType>
	<apRefundService run="true">
		<refundRequestID>7478646017836912903612</refundRequestID>
	</apRefundService>
</requestMessage>

Response to a Successful Request

<replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.211">
	<merchantReferenceCode>Sodexo-Refund</merchantReferenceCode>
	<requestID>7478650030276118403607</requestID>
	<decision>ACCEPT</decision>
	<reasonCode>100</reasonCode>
	<requestToken>AxjnrwSTlWseQvM4YVoXANgZYiy6laDXcybEyOnkH8igU/pB8igrDJpJl6MV+q1CTlWsc4uTIhXocAAA9Qt+</requestToken>
	<purchaseTotals>
		<currency>EUR</currency>
	</purchaseTotals>
	<apRefundReply>
		<reasonCode>100</reasonCode>
		<transactionID>509584430475</transactionID>
		<status>REFUNDED</status>
		<processorResponse>00006</processorResponse>
		<amount>1.00</amount>
		<dateTime>2025-05-21T22:03:24Z</dateTime>
		<reconciliationID>XEKTVAW9IXLG</reconciliationID>
		<returnRef>JXNXQANMIF3V</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 Transaction Status.