Холдирование ЮKassa: как подтвердить наличие товара до списания оплаты
Как организовать двухстадийную оплату ЮKassa: проверить состав заказа, срок холда, частичное списание и итоговый статус перед отгрузкой.
Содержание статьи
Двухстадийная оплата позволяет отделить согласие покупателя заплатить от окончательного списания. Для магазина это полезно, когда перед исполнением нужно подтвердить наличие и состав товара. Но удержание суммы имеет срок, поэтому складская проверка должна завершаться конкретным решением. Описание ЮKassa проверено 12 октября 2026 года.
Назначьте момент принятия решения
Платёж, ожидающий списания, находится в waiting_for_capture. Точный срок передаётся в expires_at; он зависит от способа оплаты. Если списание не выполнить вовремя, операция отменится. Поддерживаемые способы различаются по возможностям, поэтому режим нужно проверять для выбранного варианта оплаты.
До запуска договоритесь, кто подтверждает физическое наличие и кто разрешает списание. Это могут быть разные сотрудники, но между ними должен существовать один понятный сигнал. Фраза «товар вроде есть» не заменяет проверку нужного артикула, размера и состояния изделия, которое действительно пойдёт в заказ.
Сверьте окончательный состав
Для поддерживаемого частичного списания передают нужную сумму; неиспользованный остаток возвращается покупателю автоматически. Платёж в ожидании списания можно отменить. После успешного завершения для возврата денег используется отдельная операция возврата.
Представим учебную корзину из чайника и фильтра. При сборке выяснилось, что фильтр повреждён. Сначала согласуйте новый состав с покупателем и отразите решение в заказе. Только затем готовьте соответствующее денежное действие. Не меняйте сумму по устному сообщению склада, если менеджер ещё предлагает клиенту замену.
Поставьте контроль раньше истечения срока
В очереди заказов показывайте время, к которому нужно завершить проверку. Внутренний срок лучше определить с запасом на разбор ошибок и связь с покупателем. Это рекомендация организации работы, а не дополнительная продолжительность холда, которую обещает провайдер.
Разделите случаи: товар найден; нужна замена; покупатель не отвечает; списание уже начато, результат уточняется. Для каждого заранее назначьте ответственного и допустимый следующий шаг. Так дежурный сотрудник не будет одновременно пытаться отменить операцию и подтвердить её вслед за коллегой.
Принимайте результат по двум системам
После решения проверьте и денежную операцию, и состав внутреннего заказа. Если списали часть суммы, в поручении складу должен остаться согласованный набор товаров. Если оплату отменили, прежняя задача на сборку не должна продолжать выполняться просто потому, что была распечатана раньше.
Тестируйте успешную сборку, отсутствие части товара и полную отмену. Сверка внешнего платежа рассмотрена также в материале о платёжных ссылках. Двухстадийный сценарий считайте готовым, когда команда понимает судьбу заказа при каждом исходе, включая пропущенный срок.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы