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