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

/QUERY_cash

POST

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

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

Нижнее подчеркивание и символы cash не входят в эндпоинт метода. В документации выведены dummy-методы — для удобства чтения документации по каждому методу отдельно.

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

После того, как кассовая ссылка успешно активирована:

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

   • Платеж перейдет в конечный статус.

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

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

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

Запрос

Request body schema application/json

currency

String

Валюта.

Required

mchId

String

Requirements: <= 15 characters

MID мерчанта.

Required

outTransactionNo

Number

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

Required

signType

String

Requirements: <= 30 characters, [HMAC_SHA256]

Тип подписи.

Required

signature

String

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

Required

terId

String

TID терминала.

Required

timeStart

String

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

totalAmount

String

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

Required

tradeType

String

Requirements: [pay.paxpay.cashlink]

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

Required

version

String

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

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

Ответ

200

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

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

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

Loading...