Skip to main content

Получение статуса операции

/QUERY_xml

POST

https://qrpay.tinkoff.ru/qrpay/external/send/QUERY_xml

Метод для получения текущего статуса операции.

Endpoint метода — /send. В документации выведены dummy-методы — для удобства чтения документации по каждому методу отдельно.

Схема работы метода

После того, как QR-код успешно сгенерирован:

  1. POS-терминал опрашивает хост о статусе платежа, формируя сообщение POST/send для получения статуса платежа, пока не наступит одно из событий:

    • Платеж перейдет в терминальный статус — PAID, FAIL, REFUNDED, PARTIAL_REFUNDED или CANCEL.

    • Опрос завершится по таймауту. Периодичность и продолжительность опроса зависят от настроек POS-терминала, которые заданы при его конфигурировании.

  2. Хост получает статус сессии и формирует ответ терминалу.

  3. POS-терминал формирует и печатает чек с результатом проведения операции.

Запрос

Request body schema application/xml

currency

String

Валюта.

Required

mch_id

String

MID мерчанта.

Required

method

String

Requirements: [query]

Required

out_transaction_no

Number

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

Required

sign_type

String

Requirements: <= 30 characters, [HMAC_SHA256]

Тип подписи.

Required

sign

String

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

Required

ter_id

String

TID терминала.

Required

time_start

String

Время формирования запроса. Формат — yyyy-MM-dd'T'HH:mm:ss.

Required

total_amount

String

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

Required

trade_type

String

Requirements: <= 50 characters, [pay.paxpay.native]

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

Required

version

String

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

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

Ответ

200

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

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

Loading...

openapi@tbank.ru

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