Отмена операции

POST

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

Метод для отмены операции — ручное прерывание операции кассиром или кассовым ПО, например, нажатием красной кнопки.

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

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

После того, как кассир инициировал отмену платежа, совершаемого на этом же POS-терминале — например, нажал красную кнопку:

POS-терминал формирует сообщение POST/send c запросом на отмену — POST/operations/cancel и отправляет его на хост.
Хост получает сообщение с POS-терминала, проводит нужные проверки и возвращает ответ в зависимости от статуса сессии (платежа). Если:
- Статус соответствует успешно проведенной оплате — в зависимости от настроек хоста, возвращается ответ с кодом FAIL или инициируется операция возврата, и на POS-терминал возвращается ответ с результатом операции.
- Статус соответствует процессу проведения платежа — в зависимости от настроек хоста, возвращается ответ с кодом SUCCESS, FAIL или USINGPAY.
- Статус соответствует моменту, когда процесс остановился на сформированном QR-коде, попыток проведения платежа не было — инициируется отмена QR-кода и формируется ответ POS-терминалу о результате отмены.
Терминал печатает чек:
- «Операция прервана» — для SUCCESS и когда попыток проведения платежа не было.
- «Повторите запрос позже» — для FAIL.

Запрос

Request body schema application/xml

currency

String

Валюта.

Required

mch_id

String

MID мерчанта.

Required

method

String

Requirements: [cancel]

ori_transaction_no

Number

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

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.

total_amount

String

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

Required

trade_type

String

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

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

Required

version

String

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

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

terminal_operation_id

String<uuid>

Идентификатор терминальной операции. Формируется при инициации платежной операции.

Ответ

200

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

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

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