Сценарий закрывает боль отраслей с плавающей суммой. Заказ подтверждён, а окончательная сумма станет известна через час, день или после отгрузки.
Не путайте с подтверждением оплаты заказа — там покупатель подтверждает кодом уже сформированный платёж.
Как это работает
- Резерв. Магазин создаёт заказ с холдированием на максимально возможную сумму — например, максимальный чек поездки или полную стоимость брони. Клиент подтверждает резерв, деньги блокируются на его карте.
- Отгрузка. По факту продавец создаёт отгрузку с тем, что действительно отгружено или оказано. Отгрузок может быть сколько угодно, на каждую оформляется фискальный чек. Когда в отгрузках закрыты все позиции заказа, заблокированные средства списываются.
- Частичное списание. Если часть заказа не состоялась, отгрузка оформляется с флагом
final=true. Заказ считается выполненным, а остаток резерва разблокируется без отдельного возврата. До какой даты держится резерв, видно в полеholdTillответа на создание заказа. - Уведомление. Вашу систему о каждом шаге извещает уведомление о смене статуса — по нему запускается отгрузка, оформление документов или закрытие смены.
Если заказ не состоялся, резерв снимается отменой заказа. Деньги освобождаются на карте клиента, и списания не происходит.
Резерв берётся с запасом, списывается факт, а разница освобождается сама, как на схеме ниже.
sequenceDiagram
participant K as Покупатель
participant M as Магазин
participant I as Инвойсбокс
M->>I: заказ с холдированием на 3 000 ₽
I-->>M: paymentUrl, holdTill — 5 суток
K->>I: подтверждение, 3 000 ₽ заблокированы на карте
M->>I: отгрузка по факту на 2 400 ₽, final = true
I-->>K: списано 2 400 ₽, 600 ₽ разблокированы
I->>M: уведомление о смене статуса
Где это нужно
| Отрасль | Что резервируем | Что списываем |
|---|---|---|
| Такси и трансфер | максимальную стоимость маршрута | фактическую поездку по счётчику |
| Рестораны | сумму заказа при подтверждении | фактически поданные блюда |
| Гостиницы | стоимость проживания | проживание плюс допуслуги при выезде |
| Прокат и аренда оборудования | залог и максимальный срок | фактическое время использования |
| Розница с частичной отгрузкой | полную корзину | каждую отгруженную партию |
| Предзаказы с плавающей ценой | верхнюю границу цены | цену на момент отгрузки |
Что учесть до внедрения
- Срок жизни резерва ограничен правилами платёжной системы. Если заказ выполняется дольше, резерв нужно обновлять — уточните допустимый срок у вашего менеджера.
- Списать больше зарезервированного нельзя. Резервируйте с запасом, потому что увеличить сумму постфактум не выйдет и придётся выставлять отдельный счёт.
- Клиент видит блокировку как уменьшение доступного остатка. В интерфейсе называйте её резервом. Слово «оплата» здесь приводит к обращениям в поддержку.
В случае, если у вас возникли вопросы, пожалуйста, обратитесь к специалистам системы Инвойсбокс. Мы ответим на любые ваши вопросы!