Автоматическая отмена

POST

http://qrpay.tbank.ru/qrpay/external/api/v1/operations/AUTO_CANCEL_cash

Метод используется для автоматической отмены (QR-кода или платежа) (отмена, произведенная самим кассовым ПО в результате сбоя или запланированного поведения платежной сессии, когда что-то пошло не по плану (например, терминал не смог отобразить QR)). Примечание - нижнее подчеркивание и символы 'cash' не входят в эндпоинт метода, в документации введены dummy-методы для удобства чтения документации по каждому методу отдельно.

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

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

Кассовое ПО формирует сообщение c запросом на отмену — POST/operations/auto_cancel и отправляет его на хост.
Хост получает сообщение с кассового ПО, проводит нужные проверки и возвращает ответ в зависимости от статуса сессии (платежа). Если:

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

Кассовое ПО печатает чек c информацией об операции.

Запрос

Request body schema application/json

currency

String

Валюта

Required

mchId

String

Requirements: <= 15 characters

MID мерчанта

oriTransactionNo

Number

Номер операции. Идентификатор платежа из ответного сообщения на запрос генерации QR-кода (значение атрибута out_trade_no)

Required

outTransactionNo

Number

Порядковый номер операции на POS-устройстве

Required

signType

String

Requirements: <= 30 characters, [SOFTPOS_SHA256_HMAC, MD5, HMAC_SHA256]

Тип подписи

Required

signature

String

Подпись запроса

Required

terId

String

TID терминала

Required

timeStart

String

Время формирования запроса, pattern = "yyyy-MM-dd'T'HH:mm"

Required

totalAmount

String

Сумма платежа, тип данных в строке - number(9,2)

Required

version

String

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

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

Required

tradeType

String

Requirements: [pay.paxpay.cashlink]

Тип операции.

Ответ

200

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

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

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

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