Частичный возврат интернет-магазина нужно связывать с исходным платежом и конкретным решением по товару. Иначе повторное обращение покупателя легко превратить в повторную денежную операцию. Порядок ЮKassa проверен редакцией 12 октября 2026 года; рекомендации ниже относятся к организации обработки, а не устанавливают основания возврата покупки.

Найдите исходную операцию

Возврат создаётся для успешно завершённого платежа. Нужный тип возврата должен поддерживаться способом оплаты. В запросе указывают payment_id и возвращаемую сумму. Проверяйте также уже совершённые возвраты: их общий итог не может превысить исходную оплату.

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

Проверьте арифметику до отправки

В документации ЮKassa минимальная сумма частичного возврата — один рубль. После операции должен остаться ноль либо не менее одного рубля. Это техническое ограничение нужно учитывать при распределении сумм по отдельным позициям.

Учебный пример: из оплаты 2500 рублей ранее возвращено 700. Перед следующей заявкой команда должна видеть оставшиеся 1800, а не заново исходные 2500. Отдельно учтите согласованное распределение скидки и доставки. Не вычисляйте сумму только по нынешней цене карточки: после покупки она могла измениться.

Не закрывайте заявку по нажатию кнопки

Возврат может завершиться отменой. В cancellation_details сервис передаёт инициатора и причину; среди возможных ситуаций описана нехватка средств. Поэтому факт создания запроса не заменяет проверку конечного результата.

Рекомендуем хранить состояния «подготовлен», «передан», «подтверждён», «требует разбора» во внутреннем журнале. Это редакционная схема, а не названия статусов API. При ошибке сначала выясните судьбу уже отправленной операции, затем принимайте решение о следующем действии. Не создавайте второй возврат только потому, что покупатель повторил сообщение.

Согласуйте деньги и товарный учёт

Закрывая обращение, сопоставьте сумму с решением по товару. Возвращённое покупателю денежное средство не означает, что вещь уже принята на склад и пригодна для повторной продажи. Эти результаты должны проверяться раздельно, особенно при частичном возврате нескольких позиций.

Для команды поддержки подготовьте ответ, в котором указан подтверждённый результат без неподтверждённых обещаний срока зачисления. Похожее разделение событий разобрано в сверке наложенного платежа. В конце периода сверьте журнал обращений с операциями ЮKassa, чтобы обнаружить завершённые возвраты без закрытой заявки и обратные случаи.