Автоматическая отмена
http://qrpay.tbank.ru/qrpay/external/send/AUTO_CANCEL_xml
Метод используется для автоматической отмены (QR-кода или платежа) (отмена, произведенная самим терминалом или кассовым ПО в результате сбоя или запланированного поведения платежной сессии, когда что-то пошло не по плану (например, терминал не смог отобразить QR)). Endpoint метода - "/send", в документации введены dummy-методы для удобства чтения документации по каждому методу отдельно.
Описание работы метода
Если выполняется одно из правил генерации автоотмен, POS-терминал инициирует отмену платежа, совершаемого на этом же POS-терминале:
- POS-терминал формирует сообщение c запросом на отмену —
POST/operations/auto_cancelдля метода Автоматическая отмена JSON илиPOST/sendдля метода Автоматическая отмена XML — и отправляет его на хост. - Хост получает сообщение с POS-терминала, проводит нужные проверки и возвращает ответ в зависимости от статуса сессии (платежа). Если:
- Статус соответствует успешно проведенной оплате — в зависимости от настроек хоста, возвращается ответ с кодом
FAILили инициируется операция возврата, и на POS-терминал возвращается ответ с результатом операции. - Статус соответствует процессу проведения платежа — в зависимости от настроек хоста, возвращается ответ с кодом
SUCCESS,FAILилиUSINGPAY. - Статус соответствует моменту, когда процесс остановился на сформированном QR-коде, попыток проведения платежа не было — инициируется отмена QR-кода и формируется ответ POS-терминалу о результате отмены.
- Терминал печатает чек c соответствующей инфрмацией об операции
Запрос
Request body schema application/xml
currency
String
Валюта
Required
mch_id
String
MID мерчанта
Required
method
String
Requirements: [auto_cancel]
ori_transaction_no
Number
Номер операции. Идентификатор платежа из ответного сообщения на запрос генерации QR-кода (значение атрибута out_trade_no)
Required
out_transaction_no
Number
Порядковый номер операции qrpay на POS-устройстве
Required
sign_type
String
Requirements: <= 30 characters, [MD5]
Тип подписи
Required
sign
String
Подпись запроса
Required
ter_id
String
TID терминала
Required
time_start
String
Время формирования запроса, pattern = "yyyy-MM-dd'T'HH:mm
total_amount
String
Сумма платежа, тип данных в строке - number(9,2)
Required
trade_type
String
Requirements: [pay.paxpay.native]
Тип операции
Required
version
String
Requirements: <= 4 characters, [V1.0]
Версия интерфейса
terminal_operation_id
String<uuid>
Идентификатор терминальной операции (формируется при инициации платежной операции)
Ответ
Это полезный материал?