# Refunds

A [captured](/core-api-reference/captures.md) payment can be refunded, either totally or partially. The total refund amount cannot exceed the amount captured — if it’s equal to the amount captured the refund will be full, if it’s less the refund will be partial:

* In case of a **partial refund**, the related order's payment status is moved to `partially_refunded` and a new successful refund transaction is created.
* In case of a **full refund**, the order status is moved to `cancelled`, its payment status to `refunded`, and a new successful refund transaction is created.

A refund process can be initiated via trigger attribute either from an [order](/core-api-reference/orders.md) or from a [return](/core-api-reference/returns.md#refunding-from-a-return). The response you get when you fetch a refund contains all the information and messages provided by the [payment gateway](/core-api-reference/payment_gateways.md).

If a refund gets stuck (for any reason) on our platform but succeeds on the payment gateway, you can [unblock](/core-api-reference/transactions.md#unblocking-stuck-transactions) it by passing the `_forward` trigger attribute.

<details>

<summary>Data model</summary>

Check the related [ER diagram](/data-model/orders/orders-management.md) and explore the flowchart that illustrates how the refund resource relates to the order and the other transaction APIs.

</details>

{% hint style="info" %}
Create and delete operations are not allowed on this endpoint. You can only fetch a list of refunds or a specific single one, which can also be updated in order to mark it as succeeded, unblock it manually, or add/change common attributes (metadata, references, etc.).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.commercelayer.io/core-api-reference/refunds.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.