Refund a Payment {#concept}
===========================

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 {#concept_section_t2w_424_jyb}
----------------------------------------

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 {#x-req-fields}
=======================================================

[apPaymentType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ap-payment-type.md "")
:
Set to `ACV`.

[apRefundService_refundRequestID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ap-refund-service-refund-request-id.md "")
:
Set to the request ID included in the sale response.

[apRefundService_run](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ap-refund-service-run.md "")
:
Set to `true`.

[merchantID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-id.md "")
:

[merchantReferenceCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-reference-code.md "")
:

[purchaseTotals_currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/purchase-totals-currency.md "")
:
Set to `COP`.
{#x-req-fields_crncy}
{#x-req-fields_crncy}

[purchaseTotals_grandTotalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/purchase-totals-grand-total-amount.md "")
:

Example: Refunding a Payment {#x-ex-rest}
=========================================

Request

```
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.186">
    <merchantID>thunes_cert</merchantID>
    <merchantReferenceCode>refnum1234</merchantReferenceCode>
    <purchaseTotals>
        <currency>EUR</currency>
        <grandTotalAmount>20.00</grandTotalAmount>
    </purchaseTotals>
    <apPaymentType>ANC</apPaymentType>
    <apRefundService run="true">
        <refundRequestID>7478635704886789703607</refundRequestID>
    </apRefundService>
</requestMessage>
```

Response to a Successful Request

```
<replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.211">
	<merchantReferenceCode>Masterpass-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 {#x-req-fields}
=========================================================

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

* `FAILED`: The refund cannot be completed.
* `PENDING`: The refund request is accepted but is not completed. Send a check status request as often as necessary to obtain the information that you need. For more information, see [Check a Status](/docs/cybs/en-us/thunes/developer/all/so/thunes/thunes-ancv-intro/thunes-ancv-status-intro.md "").
  {#x-req-fields_ul_pdp_lkr_3yb}