--- 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 title: "Возвраты в Yandex\_Split\_— API и процедуры возврата средств | Документация" description: Настройте автоматические и ручные возвраты платежей. API для возвратов, сроки возврата и инструкции по работе с возвратами. --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.uz/support/split-business/ru/llms.txt # Возврат платежей После того как платеж создан, вам доступны следующие операции с ним: - **Возврат платежа** (refund) — полный или частичный возврат средств покупателю в случае, если приобретенный товар или услуга не соответствуют его ожиданиям или условиям договора. Возврат происходит после того, как покупатель уже произвел оплату, и средства списаны с его счета. [Подробнее о возврате](#refund). - **Прерывание платежа** (rollback) — принудительное прекращение обработки платежа на этапе оформления заказа. [Подробнее о прерывании](#rollback). Если вы сомневаетесь, какая операция вам нужна, используйте нашу схему: {% note warning %} Не рекомендуем одновременно выполнять возврат или прерывание для одного и того же платежа, чтобы избежать ошибок системы. {% endnote %} ## Возврат платежа {#refund} Примеры случаев, когда необходимо использовать возврат платежа: - товар не подошел по размеру или оказался с браком; - покупатель передумал и хочет вернуть товар в течение установленного законом или договором срока; - услуга не оказана или оказана с нарушениями. Инициировать возврат можно двумя способами: - в личном кабинете в разделе **Платежи**; - при помощи запросов к API. ### Возврат платежа в личном кабинете {#console-refund} {% list tabs %} - Полный возврат 1. Перейдите в раздел [Платежи](https://console.pay.yandex.uz/payments) и выберите платеж. 1. В левом нижнем углу карточки заказа нажмите кнопку **Оформить возврат**. Обратите внимание, что в карточке в поле **Цена** указана цена за единицу товара. 1. Выберите товары, которые требуется вернуть, и нажмите кнопку **Оформить полный возврат**. После подтверждения начнется процедура возврата средств. В личном кабинете статус платежа изменится на **Возвращён**. - Частичный возврат 1. Перейдите в раздел [Платежи](https://console.pay.yandex.uz/payments) и выберите платеж. 1. В левом нижнем углу карточки заказа нажмите кнопку **Оформить возврат**. Обратите внимание, что в карточке в поле **Цена** указана цена за единицу товара. 1. Выберите товар, для которого вы хотите оформить возврат. 1. Укажите количество товаров или сумму возврата в зависимости от того, что вы хотите вернуть: - Часть товаров — в поле **Количество** укажите, сколько единиц товара требуется вернуть. Сумма возврата изменится автоматически. {% note info "Ограничение" %} Количество единиц товара для возврата не должно превышать количество единиц товара в заказе. Можно указать дробное значение до 2 знаков после запятой включительно. {% endnote %} - Часть стоимости товаров — в поле **Сумма возврата** укажите сумму, которую требуется вернуть. {% note warning %} Если сумма, которая останется в заказе после возврата, не кратна количеству оставшихся единиц товара, оформить возврат нельзя — отобразится ошибка. В этом случае рекомендуем изменить сумму возврата, чтобы оставшаяся сумма стала кратна количеству единиц товара. Если это невозможно, обратитесь в [поддержку](https://yandex.uz/support/split-business/ru/support.md).. {% endnote %} 1. Нажмите кнопку **Оформить частичный возврат**. После подтверждения начнется процедура возврата средств. В личном кабинете статус платежа изменится на **Возвращён частично**. Если вы вернули сумму меньше стоимости товаров, то цена за единицу товара будет автоматически пересчитана и обновится в карточке заказа. {% endlist %} ### Возврат платежей при помощи API {#api-refund} Вы можете сделать как полный, так и частичный возврат платежа. #### Схема процесса возврата {#diagram-refund} ![](./_assets/refund-scheme.png =700x) #### Инструкция {#instruction} Ниже дана краткая инструкция по оформлению возврата. Подробные примеры и спецификацию см. на странице метода [/orders/{order_id}/refund](https://yandex.uz/support/split-business/ru/custom/backend/yandex-pay-api/order/merchant_v2_refund-post.md). 1. На бэкенде магазина вызовите метод [/orders/{order_id}/refund](https://yandex.uz/support/split-business/ru/custom/backend/yandex-pay-api/order/merchant_v2_refund-post.md). Для **полного** возврата передайте только `refundAmount`, равный сумме заказа. Для **частичного** возврата передайте `refundAmount`, равный сумме возврата, и добавьте одно из состояний корзины: - `targetCart` — итоговая корзина после возврата; - `refundCart` — возвращаемые позиции. 1. Получите ответ и дождитесь завершения операции. Нельзя одновременно проводить несколько возвратов по одному заказу. Перед отправкой повторного запроса проверьте, что текущая операция возврата завершена — находится в терминальном статусе `FAIL` или `SUCCESS`. Иначе вы получите ответ `409 Conflict` c ошибкой `ANOTHER_OPERATION_IN_PROGRESS`. Статусы возврата: | Статус | Описание | | --------- | ------------------------------------------------------------------------------- | | `PENDING` | Возврат обрабатывается. | | `FAIL` | При возврате произошла ошибка (терминальный статус). | | `SUCCESS` | Средства переведены на карту или счет покупателя (терминальный статус). | Для отслеживания изменений статуса используйте нотификации [/webhook](https://yandex.uz/support/split-business/ru/custom/backend/merchant-api/webhook.md) или запросы: - [/operations/\{external_operation_id\}/](https://yandex.uz/support/split-business/ru/custom/backend/yandex-pay-api/operation/merchant_v1_operations-get.md); - [/orders/\{order_id\}/](https://yandex.uz/support/split-business/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md). 1. После выполнения возврата статус платежа `paymentStatus` изменится на: | Статус | Описание | | -------------------- | --------------------------------------------------------------------------------------- | | `FAILED` | При возврате произошла ошибка (терминальный статус). | | `REFUNDED` | Средства переведены на карту или счет покупателя в полном объеме (терминальный статус). | | `PARTIALLY_REFUNDED` | Выполнен возврат части средств на счет покупателя (терминальный статус). | Подробнее про статусы и ошибки см. в разделах: - [Статусы платежей и операций](https://yandex.uz/support/split-business/ru/payments/statuses.md); - [Ошибки платежей и операций](https://yandex.uz/support/split-business/ru/payments/errors.md). ### Сроки возврата {#deadline} После получения информации о возврате сервис Yandex Split самостоятельно рассчитывается с покупателем. Обычно сервис инициирует расчет сразу после того, как вы оформили возврат. Сроки возврата зависят от банка покупателя и могут составлять от 1 до 30 рабочих дней. Сумма возвратов за текущий день будет удержана на следующий рабочий день из выплаты партнеру за заказ. **Пример:** в вашем магазине совершен заказ на 1000 сумов и сделан возврат на 200 сумов. За следующий рабочий день вы получите выплату 800 сумов (1000 − 200). ## Прерывание платежа {#rollback} Прервать платеж можно в любом статусе, если вы используете интеграцию с помощью [API](#api-rollback). Примеры случаев, когда необходимо использовать прерывание платежа: - покупатель передумал на кассе оплачивать заказ; - система не может обработать платеж из-за технических проблем; - покупатель начал платеж, но закрыл браузер или прервал сессию до завершения оплаты; - система случайно создала два платежа по одному заказу. ### Прерывание платежа при помощи API {#api-rollback} Чтобы прервать платеж, используйте метод [/rollback](./backend/yandex-pay-api/order/merchant_v1_rollback-post). После прерывания платеж перейдет в статус `FAILED`.