--- title: "Cancel Refund" source_url: https://docs.rapyd.net/en/cancel-refund.html lang: en --- # Cancel Refund Cancels the refund of a payment. > **Note:** > > The refund must have a status of **Completed** or **Pending**. ### Parameters ### Request Path Parameters - - refund - The ID of the refund. String starting with **refund_**. ### Request Header Parameters - - access_key - Unique access key provided by Rapyd for each authorized user. See [Developers](https://docs.rapyd.net/en/developers.md "Developers"). - - Content-Type - Indicates that the data appears in JSON format. Set to **application/json**. - - salt - Random string. Recommended length: 8-16 characters. - - signature - Signature calculated for each request individually. See [Request Signatures](https://docs.rapyd.net/en/request-signatures.md "Request Signatures"). - - timestamp - Timestamp for the request, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds). ### Response Parameters - - amount - Amount of the refund, in units defined by `currency` in the original payment. - - created_at - Time of creation of this refund, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - currency - The currency of the amount received by the original payment source. Three-letter ISO 4217 code. - - ewallets - Array of objects that define the allocation of the refund to multiple wallets. - - ewallet - ID of the wallet, a string starting with **ewallet_**. - - amount - The amount refunded to this wallet. Relevant when `percentage` is not set. - - percentage - The percentage of this payment refunded to this wallet. Relevant when `amount` is not set. - - failure_code - Indicates the reason that the refund failed. See [Card Network Errors](https://docs.rapyd.net/en/card-network-errors.md "Card Network Errors"). - - failure_reason - Indicates the reason that the refund failed. One of the following: - **lost_or_stolen_card** - **expired_or_canceled_card** - **unknown** - Empty string - - fixed_side - Indicates which side of the transaction the FX rate is fixed for. Relevant for refunds with foreign exchange. One of the following values: - **buy** - **sell** - - fx_rate - Exchange rate for the transaction. - When `fixed_side` is **buy**, `fx_rate` is the buy rate. - When `fixed_side` is **sell**, `fx_rate` is the sell rate. Decimal number as string. Relevant to refunds with foreign exchange. - - id - ID of the `refund` object. String starting with **refund_**. - - merchant_reference_id - Identifier defined by the client for reference purposes. Limit: 45 characters. - - merchant_debited_amount - Amount debited from the merchant. Relevant to refunds with foreign exchange. - - merchant_debited_currency - Indicates the currency that is debited from the merchant. Three-letter ISO 4217 code. Relevant to refunds with foreign exchange. - - merchant_ewallet - As a Payment Facilitator (PayFac), you can create a card payment and direct the funds that the sub-merchant collects to your client wallet. Relevant to a [PayFac](https://docs.rapyd.net/en/rapyd-payfac-integration-guide.md "Rapyd PayFac Integration Guide"). - - metadata - A JSON object defined by the client. See [Metadata](https://docs.rapyd.net/en/metadata.md "Metadata"). - - payment - ID of the `payment` object that the refund is credited against. String starting with **payment_**. - - payment_created_at - Time that the original payment was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - payment_method_type - The original payment method type. Use [List Payment Methods by Country](https://docs.rapyd.net/en/list-payment-methods-by-country.md "List Payment Methods by Country") for a list of supported types for a country. - - proportional_refund - Indicates whether the refund was returned in proportion to the amounts received by the wallets in the payment. Relevant to a refund for a payment split among multiple wallets. - - reason - Description of the reason for the refund, provided by the merchant. - - receipt_number - Number of the receipt for the refund, provided by the merchant. - - status - Indicates the status of the refund operation. One of the following values: - **Canceled** - The merchant canceled the refund. - **Completed** - The refund was complete. - **Error** - The refund failed since the payment object on which the refund is based is not in **closed** status. - **Rejected** - The refund was rejected by the specific payment processor for this payment. - **Pending** - The request created a refund object on the Rapyd platform, but the refund is not yet complete. For example, the refund is for a payment method that requires a customer action, such as cash, bank redirect or bank transfer. - - updated_at - Time that this refund was last updated, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - /v1/refunds - Cancel Refund - ```curl curl -X delete 'https://sandboxapi.rapyd.net/v1/refunds/refund_3677a8746636786eff448afd60ffde91' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' \ --data-raw '{}' ``` - ```json { "id": "refund_ba619571ef453fb66d39cc17b67e0084", "amount": 1.14, "payment": "payment_e13505a3b2802b54ee81829bdecbf74d", "currency": "ILS", "failure_reason": "", "failure_code": "", "metadata": {}, "reason": "Direct Refund", "status": "Cancelled", "receipt_number": 0, "created_at": 1772361734, "updated_at": 1772361748, "merchant_ewallet": null, "merchant_reference_id": "39001004", "payment_created_at": 1772361733, "payment_method_type": "il_visa_shva_card", "ewallets": [ { "ewallet": "ewallet_8818c1e4c2185f4137822ea58f952e2a", "amount": 1.14 } ], "proportional_refund": true, "merchant_debited_amount": null, "merchant_debited_currency": null, "fx_rate": null, "fixed_side": null } ```