Отмена операции
https://qrpay-secured.tbank.ru/qrpay/external/aggregators/api/v1/operations/CANCEL
Метод для отмены операции — ручное прерывание операции кассиром или кассовым ПО, например, нажатием красной кнопки.
Схема работы метода
После того, как кассир инициировал отмену платежа, совершаемого на этом же POS-терминале — например, нажал красную кнопку:
-
POS-терминал формирует сообщение c запросом на отмену —
POST /operations/cancelи отправляет его на хост. -
Хост получает сообщение с POS-терминала, проводит нужные проверки и вне зависимости от устройства, с которого отправлен запрос, и продукта под QR-кодом учитывает статус платежа:
-
платеж подтвержден — инициируется операция возврата, и на POS-терминал возвращается ответ с результатом операции;
-
платеж в процессе подтверждения — возвращается ответ с кодом 'SUCCESS', через промежуток времени инициируется операция возврата;
-
сгенерирован QR-код, попыток проведения платежа не было — инициируется отмена QR-кода, и формируется ответ POS-терминалу с результатом отмены.
-
-
POS-терминал печатает чек c соответствующей информацией об операции.
Запрос
Request body schema application/json
Required
agentId
String
Идентификатор агрегатора.
currency
String
Валюта.
Required
mchId
String
Requirements: <= 15 characters
MID мерчанта.
Required
oriTransactionNo
Number
Номер операции. Идентификатор платежа из ответного сообщения на запрос генерации QR-кода — значение атрибута out_trade_no.
Required
outTransactionNo
Number
Порядковый номер операции QRPay на POS-устройстве.
Required
signType
String
Requirements: <= 30 characters, [SOFTPOS_SHA256_HMAC, HMAC_SHA256]
Тип подписи.
Required
signature
String
Подпись запроса. Значение формируется по алгоритму в соответствии с выбранным sign_type. Подпись в примере носит справочный характер и не рассчитывалась для этого запроса.
Required
terId
String
TID терминала.
Required
timeStart
String
Время формирования запроса. Формат — yyyy-MM-dd'T'HH:mm:ss.
totalAmount
String
Сумма платежа. Тип данных в строке — number(9,2).
Required
tradeType
String
Requirements: <= 50 characters, [pay.paxpay.native]
Тип операции.
Required
version
String
Requirements: <= 4 characters, [V1.0]
Версия интерфейса.
terminalOperationId
String<uuid>
Идентификатор терминальной операции. Формируется при инициации платежной операции.
Ответ
Это полезный материал?