Оплата внутри приложения: подтверждение кодом вместо перехода на платёжную страницу

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

Постоянный покупатель с гарантийным фондом может подтвердить оплату прямо в вашем приложении: код приходит ему от Инвойсбокса, вводится на вашем экране, заказ становится оплаченным.

Три вызова вместо перехода

1. Заказ. Создание заказа с типом плательщика legal — как обычно.
2. Проверка возможности оплаты. Метод проверки отвечает, хватает ли средств фонда. Спрашивать стоит до того, как покажете покупателю кнопку: так он не упрётся в отказ на последнем шаге.
3. Код подтверждения. Запрос кода — Инвойсбокс отправляет код покупателю.
4. Подтверждение оплаты. Покупатель вводит код на вашем экране, вы передаёте его методом подтверждения, и заказ переходит в оплаченный.

Полная последовательность с участниками — в схеме взаимодействия, а весь набор методов — в разделе Гарантийный фонд.

Кому это доступно и что делать с остальными

Подтверждение кодом работает для покупателей, у которых есть договор и гарантийный фонд — что это за инструмент. Остальным нужен обычный путь, и приложение не обязано ради этого выбрасывать человека в браузер:

• Мини-приложение в потоке Инвойсбокса. Метод onCheckout открывает платёжную страницу поверх мини-приложения, а после оплаты вызывается обработчик onPaymentResult со статусом — покупатель возвращается ровно туда, откуда ушёл.
• Ссылка на оплату внутри приложения. paymentUrl из ответа на создание заказа открывается во встроенном браузере; на устройстве с приложением Инвойсбокса откроется оно.
• Оплата физлицом. Тот же заказ выдаёт чек по 54-ФЗ, последовательность — в схеме для физических лиц.

Не путайте с холдированием

Здесь деньги списываются с фонда организации, и происходит это в момент подтверждения кода. Холдирование — другое: сумма блокируется на банковской карте и списывается по факту отгрузки. Механизмы решают разные задачи и настраиваются по-разному.

Что это даёт

• Покупатель не выходит из приложения: оплата занимает столько же экранов, сколько сам заказ.
• Отказ по нехватке средств виден до кнопки оплаты, а не после неё.
• Закрывающие документы формируются как при любой другой оплате — документооборот.
• Для покупателей без фонда сценарий не ломается: платёжная страница открывается поверх и возвращает человека обратно.

Смежные кейсы

• Холдирование средств — резерв суммы на карте и списание по факту.
• B2B продажи такси и трансфера — оплата в приложении с расчётом по факту.
• Системы автоматизации ресторанов — оплата по QR-коду со стола.

Методы подтверждения оплаты »