Отмена операции

/CANCEL_xml

POST

http://qrpay.tbank.ru/qrpay/external/send/CANCEL_xml

Метод используется для отмены операции (ручное прерывание операции кассиром или кассовым ПО. Например, нажатием красной кнопки). Endpoint метода - "/send", в документации введены dummy-методы для удобства чтения документации по каждому методу отдельно.

Описание работы метода

После того, как кассир инициировал отмену платежа, совершаемого на этом же POS-терминале — например, нажал красную кнопку:

1. POS-терминал формирует сообщение POST/send c запросом на отмену — POST/operations/cancel и отправляет его на хост.

2. Хост получает сообщение с POS-терминала, проводит нужные проверки и возвращает ответ в зависимости от статуса сессии (платежа). Если:

   • Статус соответствует успешно проведенной оплате — в зависимости от настроек хоста, возвращается ответ с кодом FAIL или инициируется операция возврата, и на POS-терминал возвращается ответ с результатом операции.
   • Статус соответствует процессу проведения платежа — в зависимости от настроек хоста, возвращается ответ с кодом FAIL или USINGPAY.
   • Статус соответствует моменту, когда процесс остановился на сформированном QR-коде, попыток проведения платежа не было — инициируется отмена QR-кода и формируется ответ POS-терминалу о результате отмены.

3. Терминал печатает чек:

   • «Операция прервана» — для SUCCESS и когда попыток проведения платежа не было.
   • «Повторите запрос позже» — для FAIL.

Запрос

Request body schema application/xml

currency

String

Валюта

Required

mch_id

String

MID мерчанта

Required

method

String

Requirements: [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: <= 50 characters, [pay.paxpay.native]

Тип операции

Required

version

String

Requirements: <= 4 characters, [V1.0]

Версия интерфейса

terminal_operation_id

String<uuid>

Идентификатор терминальной операции (формируется при инициации платежной операции)

Ответ

200

Успешный запрос

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции

Loading...