Skip to main content

Возврат денежных средств

/REFUND_cash

POST

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

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

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

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

После того, как кассир инициировал возврат платежа TQR/СБП:

  1. Кассовое ПО формирует сообщение c запросом на возврат — POST/operations/refund и отправляет его на хост.

  2. Хост проводит нужные проверки и при успешном прохождении проводит возврат.

  3. Хост передает ответ на Кассовое ПО.

  4. Кассовое ПО печатает чек.

Запрос

Request body schema application/json

currency

String

Валюта.

Required

mchId

String

Requirements: <= 15 characters

MID мерчанта.

Required

oriTransactionNo

Number

Идентификатор платежа из ответного сообщения на запрос на активацию кассовой ссылки — значение поля outTradeNo.

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.

Required

totalAmount

String

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

Required

version

String

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

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

Required

tradeType

String

Requirements: [pay.paxpay.cashlink]

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

Ответ

200

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

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

Loading...

openapi@tbank.ru

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