Refund - Возврат средств
Запрос выполняется командой Refund.
Запрос используется для осуществления возврата денежных средств на карту Пользователя, предварительно списанных командой Charge.
Результатом обработки запроса является возврат (полный или частичный) списанных денежных средств на карту Пользователя.
Внимание: для успешного возврата необходимо, чтобы на момент исполнения запроса платеж имел статус Charged.
| Название |
Описание |
Формат |
Обязательный |
| Key |
Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа |
Строка |
Да |
| OrderId |
Идентификатор платежа в системе theMAP |
Строка (максимум 50 символов) |
Да |
| Amount |
Сумма для возврата в минимальных единицах валюты (копейках) |
Цифры, не содержащие десятичных или других разделителей |
Да |
Пример запроса POST:
https://{domain}/Refund
Key:TestTerminal
Amount:300
OrderId:TestOrder123
Пример реализации запроса в программном коде:
curl -X POST \
https://https://{domain}/Refund \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'Key=TestTerminal&Amount=300&OrderId=TestOrder123'
| Название |
Описание |
Формат |
| Success |
Флаг успешности операции |
true/false |
| OrderId |
Идентификатор платежа в системе Продавца. Передается, если «Success=true» |
Соответсвует переданному в запросе |
| Key |
Идентификатор Продавца в системе theMAP. Передается, если «Success=true» |
Соответсвует переданному в запросе |
| NewAmount |
Измененная списанная сумма в копейках. Передается, если «Success=true» |
Цифры, не содержащие десятичных или других разделителей |
| ErrCode |
Описание ошибки. Передается пустой, если «Success=true» |
см. коды ошибок |
| ErrMessage |
Опциональный параметр. Дополнительное описание ошибки. Передается пустой, если «Success=true» |
Строка |
| CustomParams |
Параметр является опциональным. Список дополнительных параметров операции |
Соответствует Params, переданному в запросе Block |
| FeePercent |
Параметр является опциональным. Ставка комиссии за эквайринг, в десятых долях от числа |
Число |
| TerminalID |
Параметр является опциональным. Id терминала в системе MAP, по которому фактически выполнена операция |
Число |
| BankName |
Параметр является опциональным. Наименование Банка-эмитента |
Строка |
| ProcessingResponse |
Параметр является опциональным. Оригинальный отказ эквайера |
Строка |
| RRN |
Параметр является опциональным. RRN операции |
Строка |
Пример ответа на успешный запрос:
{
"Success": true,
"OrderId": "TestOrder123",
"NewAmount": 0,
"ErrCode": ""
}
Пример ответа на не успешный запрос:
{
"Success": false,
"OrderId": "TestOrder123",
"Key": "TestTerminal",
"NewAmount": 0,
"ErrCode": "AMOUNT_EXCEED"
}