Торговые операции с QR-кодом

С помощью методов TACAP API вы можете проводить торговые операции с QR-кодом:

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

Методы в документации

Генерация QR-кода

Для инициации оплаты устройство отправляет запрос на генерацию QR-кода:

1. Система формирует запрос сообщение POST/send для метода Сгенерировать динамический код XML или POST/operations/qrpay для метода Сгенерировать динамический код JSON c запросом на регистрацию платежа и отправляет его на хост.
2. Хост проводит обработку запроса, определяет вид QR-кода — например, СБП или TQR — и генерирует его. Вид генерируемого типа QR-кода зависит от данных устройства, которые были указаны при его регистрации или обновлении.
3. Хост формирует и передает ответ устройству.
4. Устройство на свой запрос получает ответ с QR-кодом в виде URL.

Запрос статуса платежной операции

После того, как QR-код успешно сгенерирован:

1. Устройство опрашивает хост о статусе платежа, формируя сообщение POST/send для метода Получить статус операции XML или POST/operations/query для метода Получить статус операции JSON, пока не наступит одно из событий:

   • Платеж перейдет в терминальный статус — PAID, FAIL, REFUNDED, PARTIAL_REFUNDED, CANCEL или EXPIRED.
   • Опрос завершится по таймауту. Периодичность и продолжительность опроса зависят от настроек устройства, которые заданы при его конфигурировании.

2. Хост получает статус сессии и формирует ответ устройству.

3. Устройство обрабатывает ответ с результатом проведения операции.

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

Клиентская система может инициировать отмену операции:

1. Устройство формирует сообщение c запросом на отмену — POST/operations/cancel для метода Отменить операцию JSON или POST/send для метода Отменить операцию XML — и отправляет его на хост.
2. Хост получает сообщение от устройства, проводит нужные проверки и возвращает ответ в зависимости от статуса сессии (платежа). Если:
   • Статус соответствует успешно проведенной оплате — в зависимости от настроек хоста, возвращается ответ с кодом FAIL или инициируется операция возврата, и на устройство возвращается ответ с результатом операции.
   • Статус соответствует процессу проведения платежа — в зависимости от настроек хоста, возвращается ответ с кодом FAIL или USINGPAY.
   • Статус соответствует моменту, когда процесс остановился на сформированном QR-коде, попыток проведения платежа не было — инициируется отмена QR-кода и формируется ответ устройству о результате отмены.
3. Устройство обрабатывает ответ от хоста, одна из возможных интерпретаций кода в ответе:
   • Операция прервана — для SUCCESS и когда попыток проведения платежа не было.
   • Повторите запрос позже — для FAIL.

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

После того, как клиентская система инициировала возврат платежа TQR/СБП:

1. Устройство формирует сообщение c запросом на возврат — POST/operations/refund для метода Вернуть денежные средства JSON или POST/send для метода Вернуть денежные средства XML — и отправляет его на хост.
2. Хост проводит нужные проверки и при успешном прохождении проводит возврат.
3. Хост передает ответ на устройство.
4. Устройство обрабатывает ответ.

Автоотмена платежа по QR

Если выполняется одно из правил генерации автоотмен, устройство инициирует отмену платежа, совершаемого на этом же устройстве:

1. Устройство формирует сообщение c запросом на отмену — POST/operations/auto_cancel для метода Автоматическая отмена JSON или POST/send для метода Автоматическая отмена XML — и отправляет его на хост.
2. Хост получает сообщение с устройства, проводит нужные проверки и возвращает ответ в зависимости от статуса сессии (платежа). Если:
   • Статус соответствует успешно проведенной оплате — в зависимости от настроек хоста, возвращается ответ с кодом FAIL или инициируется операция возврата, и на устройство возвращается ответ с результатом операции.
   • Статус соответствует процессу проведения платежа — в зависимости от настроек хоста, возвращается ответ с кодом SUCCESS, FAIL или USINGPAY.
   • Статус соответствует моменту, когда процесс остановился на сформированном QR-коде, попыток проведения платежа не было — инициируется отмена QR-кода и формируется ответ устройству о результате отмены.
3. Устройство обрабатывает ответ от хоста, одна из возможных интерпретаций кода в ответе:
   • Операция прервана — для SUCCESS и когда попыток проведения платежа не было.
   • Повторите запрос позже — для FAIL.