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

/QUERY

POST

https://qrpay.tinkoff.ru/qrpay/external/api/v1/operations/QUERY

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

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

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

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

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

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

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

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

Запрос

Request body schema application/json

currency

String

Валюта.

Required

mchId

String

Requirements: <= 15 characters

MID мерчанта.

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]

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

Ответ

200

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

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

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

Loading...