--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://pay.yandex.ru/docs/ru/custom/refund-payments.md - href: ru/custom/refund-payments.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt title: "Возвраты в Яндекс\_Пэй\_— API и процедуры возврата средств | Документация" description: Настройте автоматические и ручные возвраты платежей. API для возвратов, сроки возврата и инструкции по работе с возвратами. --- > **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/ru/llms.txt # Возврат платежей После того как платеж создан, вам доступны следующие операции с ним: - **Возврат платежа** (refund) — полный или частичный возврат средств покупателю в случае, если приобретенный товар или услуга не соответствуют его ожиданиям или условиям договора. Возврат происходит после того, как покупатель уже произвел оплату, и средства списаны с его счета. [Подробнее о возврате](#refund). - **Отмена платежа** (cancel) — отмена холдирования средств на счете покупателя. Отменить можно только авторизованный двухстадийный платеж — средства заблокированы на счете покупателя, но еще не списаны. [Подробнее об отмене](#cancel). - **Прерывание платежа** (rollback) — принудительное прекращение обработки платежа на этапе оформления заказа. [Подробнее о прерывании](#rollback). Если вы сомневаетесь, какая операция вам нужна, используйте нашу схему: ![](_assets/refund-cancel-scheme-ru.svg){width=900px} {% note warning %} Не рекомендуем одновременно выполнять возврат, отмену или прерывание для одного и того же платежа, чтобы избежать ошибок системы. {% endnote %} ## Возврат платежа {#refund} {% note info %} Возвраты проводятся в соответствии с п. 4.3. [Условий сервиса Яндекс Пэй для партнеров](https://yandex.ru/legal/yandexpay_b2b/). Минимальная сумма возврата — 1 рубль. {% endnote %} Примеры случаев, когда необходимо использовать возврат платежа: - товар не подошел по размеру или оказался с браком; - покупатель передумал и хочет вернуть товар в течение установленного законом или договором срока; - услуга не оказана или оказана с нарушениями. Инициировать возврат можно двумя способами: - в личном кабинете в разделе **Платежи**; - при помощи запросов к API. ### Возврат платежа в личном кабинете {#console-refund} Как оформить возврат в личном кабинете Яндекс Пэй, смотрите в нашем видео: {% list tabs %} - Полный возврат 1. Перейдите в раздел [Платежи](https://console.pay.yandex.ru/payments) и выберите платеж. 1. В левом нижнем углу карточки заказа нажмите кнопку **Оформить возврат**. ![image](../custom/_assets/refund-1.png){.c-screenshot width=85%} Обратите внимание, что в карточке в поле **Цена** указана цена за единицу товара. 1. Выберите товары, которые требуется вернуть, и нажмите кнопку **Оформить полный возврат**. ![image](./_assets/refund-2.png){.c-screenshot width=85%} После подтверждения начнется процедура возврата средств. В личном кабинете статус платежа изменится на **Возвращён**. - Частичный возврат {% note alert %} Сервис временно не поддерживает синхронизацию данных о частичных возвратах с [CMS-модулями](https://pay.yandex.ru/docs/ru/cms/index.md) — если вы оформите частичный возврат в личном кабинете Яндекс Пэй, информация о нем может отображаться в вашей CMS некорректно. Учитывайте эту особенность при оформлении возвратов. {% endnote %} 1. Перейдите в раздел [Платежи](https://console.pay.yandex.ru/payments) и выберите платеж. 1. В левом нижнем углу карточки заказа нажмите кнопку **Оформить возврат**. ![image](../custom/_assets/refund-1.png){.c-screenshot width=85%} Обратите внимание, что в карточке в поле **Цена** указана цена за единицу товара. 1. Выберите товар, для которого вы хотите оформить возврат. ![image](./_assets/refund-4.png){.c-screenshot width=85%} 1. Укажите количество товаров или сумму возврата в зависимости от того, что вы хотите вернуть: - Часть товаров — в поле **Количество** укажите, сколько единиц товара требуется вернуть. Сумма возврата изменится автоматически. {% note info "Ограничение" %} Количество единиц товара для возврата не должно превышать количество единиц товара в заказе. Можно указать дробное значение до 2 знаков после запятой включительно. {% endnote %} - Часть стоимости товаров — в поле **Сумма возврата** укажите сумму, которую требуется вернуть. {% note warning %} Если сумма, которая останется в заказе после возврата, не кратна количеству оставшихся единиц товара, оформить возврат нельзя — отобразится ошибка. В этом случае рекомендуем изменить сумму возврата, чтобы оставшаяся сумма стала кратна количеству единиц товара. Если это невозможно, обратитесь в [поддержку](https://console.pay.yandex.ru/support).. {% endnote %} {% cut "Пример" %} В этом платеже мы возвращаем 1000 рублей для одной единицы товара: ![image](./_assets/refund-5.png){.c-screenshot width=85%} {% endcut %} 1. Нажмите кнопку **Оформить частичный возврат**. После подтверждения начнется процедура возврата средств. В личном кабинете статус платежа изменится на **Возвращён частично**. Если вы вернули сумму меньше стоимости товаров, то цена за единицу товара будет автоматически пересчитана и обновится в карточке заказа. {% endlist %} ### Возврат платежей при помощи API {#api-refund} Вы можете сделать как полный, так и частичный возврат платежа. {% note warning "Нельзя оформить возврат, если:" %} - сумма возврата меньше 1 рубля; - после возврата в заказе останется меньше 1 рубля. {% endnote %} #### Схема процесса возврата {#diagram-refund} ![](./_assets/refund-scheme.png){width=700} #### Инструкция {#instruction} Ниже дана краткая инструкция по оформлению возврата. Подробные примеры и спецификацию см. на странице метода [/orders/{order_id}/refund](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v2_refund-post.md). 1. На бэкенде магазина вызовите метод [/orders/{order_id}/refund](https://pay.yandex.ru/docs/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://pay.yandex.ru/docs/ru/custom/backend/merchant-api/webhook.md) или запросы: - [/operations/\{external_operation_id\}/](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/operation/merchant_v1_operations-get.md); - [/orders/\{order_id\}/](https://pay.yandex.ru/docs/ru/custom/backend/yandex-pay-api/order/merchant_v1_order-get.md). 1. После выполнения возврата статус платежа `paymentStatus` изменится на: | Статус | Описание | | -------------------- | --------------------------------------------------------------------------------------- | | `FAILED` | При возврате произошла ошибка (терминальный статус). | | `REFUNDED` | Средства переведены на карту или счет покупателя в полном объеме (терминальный статус). | | `PARTIALLY_REFUNDED` | Выполнен возврат части средств на счет покупателя (терминальный статус). | Подробнее про статусы и ошибки см. в разделах: - [Статусы платежей и операций](https://pay.yandex.ru/docs/ru/payments/statuses.md); - [Ошибки платежей и операций](https://pay.yandex.ru/docs/ru/payments/errors.md). ### Сроки возврата {#deadline} После получения информации о возврате сервис Яндекс Пэй самостоятельно рассчитывается с покупателем согласно разделу 6 [Условий использования сервиса Яндекс Пэй](https://yandex.ru/legal/yandexpay_b2c/). Обычно сервис инициирует расчет сразу после того, как вы оформили возврат. Сроки возврата зависят от банка покупателя и могут составлять от 1 до 30 рабочих дней. Сумма возвратов за текущий день будет удержана на следующий рабочий день из выплаты партнеру за заказ. **Пример:** в вашем магазине совершен заказ на 1000 рублей и сделан возврат на 200 рублей. За следующий рабочий день вы получите выплату 800 рублей (1000 − 200). ## Отмена платежа {#cancel} {% note warning %} Частично отменить платеж не получится — вернуть средства можно только полностью. {% endnote %} Примеры случаев, когда необходимо использовать отмену платежа: - покупатель передумал оплачивать заказ до момента списания средств; - система ждет подтверждения двухстадийного платежа, но таймер на оплату заказа истек; - платеж авторизован, но товара не оказалось в наличии; - продавец решил отменить заказ по своей инициативе. {% note info %} Если вы отменили платеж в день его создания, комиссия сервиса за этот платеж не взимается. {% endnote %} Отменить платеж можно двумя способами: - в личном кабинете в разделе **Платежи**; - при помощи запросов к API. ### Отмена платежа в личном кабинете {#console-cancel} 1. Перейдите в раздел [Платежи](https://console.pay.yandex.ru/payments) и выберите платеж в статусе **Платеж авторизован**. 1. Нажмите кнопку **Отменить заказ** — платеж перейдет в статус **Отменен**. Средства будут разблокированы на счете покупателя. ### Отмена платежа при помощи API {#api-cancel} Отменить платеж можно с помощью метода [/cancel](./backend/yandex-pay-api/order/merchant_v1_cancel-post). Он отменяет холдирование средств на счете покупателя. Используйте этот метод только для платежей в статусе `AUTHORIZED`. После отмены платеж перейдет в статус `VOIDED`. ## Прерывание платежа {#rollback} Прервать платеж можно в любом статусе, если вы используете интеграцию с помощью [API](#api-rollback) или принимаете платеж вручную по [QR-коду](#qr-rollback) в личном кабинете Яндекс Пэй. Примеры случаев, когда необходимо использовать прерывание платежа: - покупатель передумал на кассе оплачивать заказ; - система не может обработать платеж из-за технических проблем; - покупатель начал платеж, но закрыл браузер или прервал сессию до завершения оплаты; - система случайно создала два платежа по одному заказу. ### Прерывание платежа при помощи API {#api-rollback} Чтобы прервать платеж, используйте метод [/rollback](./backend/yandex-pay-api/order/merchant_v1_rollback-post). После прерывания платеж перейдет в статус `FAILED`. ### Прерывание платежа по QR-коду {#qr-rollback} {% note warning %} Прервать оплату по QR-коду можно, только если клиент еще не оплатил заказ. {% endnote %} Если вы принимаете [оплату по QR-коду](https://pay.yandex.ru/docs/ru/console/create-link.md#qr) от Яндекс Пэй в личном кабинете, чтобы прервать оплату: 1. В личном кабинете Яндекс Пэй в окне ожидания оплаты под QR-кодом нажмите кнопку **Отменить**. 1. Подтвердите отмену. Оплата будет прервана, клиент не сможет оплатить заказ.