Возврат платежей

После того как платеж создан, вам доступны следующие операции с ним:

• Возврат платежа (refund) — полный или частичный возврат средств покупателю в случае, если приобретенный товар или услуга не соответствуют его ожиданиям или условиям договора. Возврат происходит после того, как покупатель уже произвел оплату, и средства списаны с его счета. Подробнее о возврате.

• Отмена платежа (cancel) — отмена холдирования средств на счете покупателя. Отменить можно только авторизованный двухстадийный платеж — средства заблокированы на счете покупателя, но еще не списаны. Подробнее об отмене.

• Прерывание платежа (rollback) — принудительное прекращение обработки платежа на этапе оформления заказа. Подробнее о прерывании.

Если вы сомневаетесь, какая операция вам нужна, используйте нашу схему:

Возврат платежа

Примеры случаев, когда необходимо использовать возврат платежа:

• товар не подошел по размеру или оказался с браком;
• покупатель передумал и хочет вернуть товар в течение установленного законом или договором срока;
• услуга не оказана или оказана с нарушениями.

Инициировать возврат можно двумя способами:

• в личном кабинете в разделе Платежи;
• при помощи запросов к API.

Возврат платежа в личном кабинете

Как оформить возврат в личном кабинете Яндекс Пэй, смотрите в нашем видео:

Возврат платежей при помощи API

Вы можете сделать как полный, так и частичный возврат платежа.

Схема процесса возврата

Инструкция

Ниже дана краткая инструкция по оформлению возврата. Подробные примеры и спецификацию см. на странице метода /orders/{order_id}/refund.

1. На бэкенде магазина вызовите метод /orders/{order_id}/refund.

   Для полного возврата передайте только refundAmount, равный сумме заказа.

   Для частичного возврата передайте refundAmount, равный сумме возврата, и добавьте одно из состояний корзины:

   • targetCart — итоговая корзина после возврата;

   • refundCart — возвращаемые позиции.

2. Получите ответ и дождитесь завершения операции.

   Нельзя одновременно проводить несколько возвратов по одному заказу. Перед отправкой повторного запроса проверьте, что текущая операция возврата завершена — находится в терминальном статусе FAIL или SUCCESS.

   Иначе вы получите ответ 409 Conflict c ошибкой ANOTHER_OPERATION_IN_PROGRESS.

   Статусы возврата:

   Статус	Описание
   PENDING	Возврат обрабатывается.
   FAIL	При возврате произошла ошибка (терминальный статус).
   SUCCESS	Средства переведены на карту или счет покупателя (терминальный статус).

   Для отслеживания изменений статуса используйте нотификации /webhook или запросы:

   • /operations/{external_operation_id}/;
   • /orders/{order_id}/.

3. После выполнения возврата статус платежа paymentStatus изменится на:

   Статус	Описание
   FAILED	При возврате произошла ошибка (терминальный статус).
   REFUNDED	Средства переведены на карту или счет покупателя в полном объеме (терминальный статус).
   PARTIALLY_REFUNDED	Выполнен возврат части средств на счет покупателя (терминальный статус).

Подробнее про статусы и ошибки см. в разделах:

• Статусы платежей и операций;
• Ошибки платежей и операций.

Сроки возврата

После получения информации о возврате сервис Яндекс Пэй самостоятельно рассчитывается с покупателем согласно разделу 6 Условий использования сервиса Яндекс Пэй. Обычно сервис инициирует расчет сразу после того, как вы оформили возврат.

Сроки возврата зависят от банка покупателя и могут составлять от 1 до 30 рабочих дней.

Сумма возвратов за текущий день будет удержана на следующий рабочий день из выплаты партнеру за заказ.

Пример: в вашем магазине совершен заказ на 1000 рублей и сделан возврат на 200 рублей. За следующий рабочий день вы получите выплату 800 рублей (1000 − 200).

Отмена платежа

Примеры случаев, когда необходимо использовать отмену платежа:

• покупатель передумал оплачивать заказ до момента списания средств;
• система ждет подтверждения двухстадийного платежа, но таймер на оплату заказа истек;
• платеж авторизован, но товара не оказалось в наличии;
• продавец решил отменить заказ по своей инициативе.

Отменить платеж можно двумя способами:

• в личном кабинете в разделе Платежи;
• при помощи запросов к API.

Отмена платежа в личном кабинете

1. Перейдите в раздел Платежи и выберите платеж в статусе Платеж авторизован.

2. Нажмите кнопку Отменить заказ — платеж перейдет в статус Отменен. Средства будут разблокированы на счете покупателя.

Отмена платежа при помощи API

Отменить платеж можно с помощью метода /cancel. Он отменяет холдирование средств на счете покупателя.

Используйте этот метод только для платежей в статусе AUTHORIZED. После отмены платеж перейдет в статус VOIDED.

Прерывание платежа

Прервать платеж можно в любом статусе, если вы используете интеграцию с помощью API или принимаете платеж вручную по QR-коду в личном кабинете Яндекс Пэй.

Примеры случаев, когда необходимо использовать прерывание платежа:

• покупатель передумал на кассе оплачивать заказ;
• система не может обработать платеж из-за технических проблем;
• покупатель начал платеж, но закрыл браузер или прервал сессию до завершения оплаты;
• система случайно создала два платежа по одному заказу.

Прерывание платежа при помощи API

Чтобы прервать платеж, используйте метод /rollback. После прерывания платеж перейдет в статус FAILED.

Прерывание платежа по QR-коду

Если вы принимаете оплату по QR-коду от Яндекс Пэй в личном кабинете, чтобы прервать оплату:

1. В личном кабинете Яндекс Пэй в окне ожидания оплаты под QR-кодом нажмите кнопку Отменить.
2. Подтвердите отмену. Оплата будет прервана, клиент не сможет оплатить заказ.