---
metadata:
- name: generator
content: Diplodoc Platform v5.48.2
alternate:
- https://yandex.uz/support/split-business/en/custom/refund-payments.md
- https://yandex.uz/support/split-business/ru/custom/refund-payments.md
- https://yandex.uz/support/split-business/uz/custom/refund-payments.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.uz/support/split-business/en/llms.txt
# Payment refunds
After a payment is created, the following operations are available:
- **Refund**: Full or partial return of funds to the customer if the purchased product or service does not meet expectations or contract terms. A refund is processed after the customer has completed payment and the funds have been debited from their account. [Learn more about refunds](#refund).
- **Rollback**: Forced termination of payment processing at the order stage. [Learn more about rollbacks](#rollback).
If you are unsure which operation to use, refer to these instructions:
{% note warning %}
We do not recommend performing a refund and a rollback simultaneously for the same payment to avoid system errors.
{% endnote %}
## Payment refund {#refund}
Examples of when a refund should be used:
- The size of an item doesn't fit or the item is defective.
- The customer has changed their mind and wants to return an item within the period allowed by law or the agreement terms.
- A service was not provided or was provided improperly.
A refund can be initiated in two ways:
- In the personal account, the **Payments** section.
- By making API requests.
### Making a refund in the personal account {#console-refund}
{% list tabs %}
- Full refund
1. Go to [Payments](https://console.pay.yandex.uz/payments) and select a payment.
1. In the bottom-left corner of the order card, click **Apply for refund**.
Please note that the card's **Price** field specifies the price per unit.
1. Select the items to refund and click **Apply for full refund**.
Once confirmed, the refund procedure starts. The payment status in the personal account changes to **Refunded**.
- Partial refund
1. Go to [Payments](https://console.pay.yandex.uz/payments) and select a payment.
1. In the bottom-left corner of the order card, click **Apply for refund**.
Please note that the card's **Price** field specifies the price per unit.
1. Select the item to refund.
1. Specify the number of items or the refund amount depending on what you want to return:
- Some items: In the **Quantity** field, specify the number of items to be returned. The refund amount changes automatically.
{% note info "Restriction" %}
The number of items for a refund should not exceed the number of items in the order. You can set a non-integer value with up to 2 decimal places.
{% endnote %}
- Part of the item cost: In the **Refund amount** field, specify the amount to be refunded.
{% note warning %}
If the remaining order total after the refund is not divisible by the remaining quantity of items, the refund cannot be processed and an error is returned.
In that case, change the refund amount so that the remaining value can be divided by the number of items. If this is not possible, contact [support](https://yandex.uz/support/split-business/en/support.md).
{% endnote %}
1. Click **Apply for partial refund**. Once confirmed, the refund procedure starts. The payment status in the personal account changes to **Refunded in part**.
If the amount you refunded is less than the cost of items, the price per unit is automatically recalculated and updated in the order card.
{% endlist %}
### Making refunds via the API {#api-refund}
You can refund a payment in full or in part.
#### Refund workflow {#diagram-refund}
#### Instructions {#instruction}
Below are brief instructions on how to make a refund. For detailed examples and specifications, see the [/orders/{order_id}/refund](https://yandex.uz/support/split-business/en/custom/backend/yandex-pay-api/order/merchant_v2_refund-post.md) method page.
1. Call the [/orders/{order_id}/refund](https://yandex.uz/support/split-business/en/custom/backend/yandex-pay-api/order/merchant_v2_refund-post.md) method on the store's backend.
To make a **full** refund, pass only the `refundAmount` parameter that is equal to the order amount.
To make a **partial** refund, pass the `refundAmount` parameter that is equal to the refund amount and add one of the cart statuses:
- `targetCart`: Final cart after the refund.
- `refundCart`: Items refunded.
1. Get a response and wait for the operation to complete.
You cannot process multiple refunds for the same order simultaneously. Before sending a repeated request, verify that the current refund operation is complete and in a terminal status — `FAIL` or `SUCCESS`.
Otherwise, you'll get a `409 Conflict` response with an error message saying `ANOTHER_OPERATION_IN_PROGRESS`.
Refund statuses:
| Status | Description |
| --------- | ------------------------------------------------------------------------------- |
| `PENDING` | Refund is being handled. |
| `FAIL` | A refund error occurred (terminal status). |
| `SUCCESS` | The funds have been transferred to the customer's bank card or account (terminal status). |
To track the status changes, use [/webhook](https://yandex.uz/support/split-business/en/custom/backend/merchant-api/webhook.md) notifications or the following requests:
- [/operations/\{external_operation_id\}/](https://yandex.uz/support/split-business/en/custom/backend/yandex-pay-api/operation/merchant_v1_operations-get.md)
- [/orders/\{order_id\}/](https://yandex.uz/support/split-business/en/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md)
1. Once a refund is made, the `paymentStatus` changes to:
| Status | Description |
| -------------------- | --------------------------------------------------------------------------------------- |
| `FAILED` | A refund error occurred (terminal status). |
| `REFUNDED` | The funds have been transferred to the customer's card or account (terminal status). |
| `PARTIALLY_REFUNDED` | Part of the funds has been refunded to the customer's card or account (terminal status). |
To learn more about statuses and errors, see:
- [Payment and operation statuses](https://yandex.uz/support/split-business/en/payments/statuses.md).
- [Payment and operation errors](https://yandex.uz/support/split-business/en/payments/errors.md).
### Refund period {#deadline}
After Yandex Split gets the refund details, it makes settlements with the customer on its own. As a rule, the service initiates settlements immediately after you make the refund.
The refund period depends on the customer's bank. It may take from 1 to 30 business days.
The total refund amount for the current day is withheld the next business day from the partner payout for the order.
**Example:** An order for som 1000 is placed at your store and a refund of som 200 is issued. On the next business day, you receive a payout of 800 som (1000 − 200).
## Rolling back a payment {#rollback}
You can roll back a payment in any status if you're using [API](#api-rollback) integration.
Examples of when a rollback should be used:
- The customer decides not to pay for the order at checkout.
- The system can't handle a payment due to technical issues.
- The customer has started making a payment but then closed the browser or terminated the session before the payment is completed.
- The system has accidentally created two payments for the same order.
### Rolling back a payment via the API {#api-rollback}
To roll back a payment, call the [/rollback](./backend/yandex-pay-api/order/merchant_v1_rollback-post) method. Once rolled back, the payment status changes to `FAILED`.