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

/REFUND

POST

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

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

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

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

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

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

3. Хост передает ответ на POS-терминал.

4. Терминал печатает чек.

Запрос

Request body schema application/json

currency

String

Валюта.

Required

mchId

String

Requirements: <= 15 characters

MID мерчанта.

Required

oriTransactionNo

Number

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

Required

outTransactionNo

Number

Порядковый номер операции на 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.

Required

totalAmount

String

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

Required

tradeType

String

Requirements: [pay.paxpay.native]

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

Required

version

String

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

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

Ответ

200

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

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

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

Сценарий использования

Возврат платежа по QR

Пример запроса

Payload

cURL

Go

Java

NodeJs

PHP

Python

Content type

application/json

{

"currency":

"RUB",

"mchId":

"000000000000001",

"oriTransactionNo":

551123123,

"outTransactionNo":

22210,

"signType":

"HMAC_SHA256",

"signature":

"b613679a0814d9ec772f95d778c35fc5ff1697c493715653c6c712144292c5ad",

"terId":

"40051625",

"timeStart":

"2021-07-22T17:30:28",

"totalAmount":

"10000.05",

"tradeType":

"pay.paxpay.native",

"version":

"V1.0"

}

Пример ответа

200

Content type

application/json

{

"code":

"SUCCESS",

"msg": {

},

"signType":

"HMAC_SHA256",

"signature":

"b613679a0814d9ec772f95d778c35fc5ff1697c493715653c6c712144292c5ad",

"method":

"refund",

"mchId":

"000000000000001",

"terId":

"40051625",

"outTransactionNo":

"22210",

"timeStart":

"2021-07-22T17:30:28",

"currency":

"RUB",

"outTradeNo":

"551123123",

"tradeTime":

"2021-07-22T17:30:33",

"tradeType":

"pay.paxpay.native",

"transactionNo": {

},

"version":

"V1.0",

"merchantName":

"IP AJRAPETYAN G S",

"merchantAddress":

"353911, Краснодарский край, г Новороссийск, ш Сухумское, 110"

}