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
.
apRefundService_refundRequestID: Set to the request ID included in the sale response.
apRefundService_run: Set to
true
.
merchantID
merchantReferenceCode
purchaseTotals_currency: Set to
.
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>BNC</apPaymentType>
	<apRefundService run="true">
		<refundRequestID>7454180061226575403608</refundRequestID>
	</apRefundService>
</requestMessage>

Response to a Successful Request

<replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.215">
	<merchantReferenceCode>Bancontact-Refund</merchantReferenceCode>
	<requestID>7479270326816914803612</requestID>
	<decision>ACCEPT</decision>
	<reasonCode>100</reasonCode>
	<requestToken>AxjnrwSTlXO5/14R9AucANgZYjWmdmDXZ15FqCnvy2Y3sHpB8igtDJpJl6MYhzFqTlXOxtPrSX4pXAAA0hgx</requestToken>
	<purchaseTotals>
		<currency>EUR</currency>
	</purchaseTotals>
	<apRefundReply>
		<reasonCode>100</reasonCode>
		<transactionID>210101503502</transactionID>
		<status>REFUNDED</status>
		<processorResponse>00006</processorResponse>
		<amount>1.00</amount>
		<dateTime>2025-05-22T15:17:14Z</dateTime>
		<reconciliationID>XFZ3YAW3WHZA</reconciliationID>
		<returnRef>XFZ3ZAXML4ZM</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.