Перейти к основному содержимому

Деактивация кассовой ссылки

/CANCEL_cash

POST

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

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

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

После того, как кассир инициировал отмену кассовой ссылки, активированной на этом же кассовом ПО:

  1. Кассовое ПО формирует сообщение c запросом на деактивацию — POST/operations/cancel и отправляет его на хост.
  2. Хост получает сообщение с кассового ПО, проводит нужные проверки и возвращает ответ в зависимости от статуса сессии (платежа). Если:
  • Статус соответствует успешно проведенной оплате — возвращается ответ с кодом FAIL.
  • Статус соответствует процессу проведения платежа — возвращается ответ с кодом FAIL.
  • Статус соответствует моменту, когда процесс остановился на активированном QR-коде, попыток проведения платежа не было — инициируется деактивация кассовой ссылки и формируется ответ c кодом SUCCESS кассовому ПО о результате отмены.
  1. Кассовое ПО печатает чек 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

Подпись запроса. Значение формируется по алгоритму в соответствии с выбранным sign_type. Подпись в примере указана справочно и не является рассчитанной для данного запроса

Required

terId

String

TID терминала

Required

timeStart

String

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

totalAmount

String

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

Required

tradeType

String

Requirements: [pay.paxpay.cashlink]

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

Required

version

String

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

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

Ответ

200

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

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

Loading...

openapi@tbank.ru

АО «ТБанк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.