Unblock - Разблокировка средств на карте
Запрос выполняется командой Unblock.
Запрос используется для осуществления разблокировки денежных средств с карты Пользователя, предварительно заблокированных командой Block.
В результате успешной обработки запроса разблокированные денежные средства становятся доступными на карте Пользователя.
Внимание: для успешного списания необходимо, чтобы на момент исполнения запроса платеж имел статус Authorized
| Название |
Описание |
Формат |
Обязательный |
| Key |
Идентификатор Продавца. Выдается Продавцу с параметрами тестового/боевого доступа |
Строка |
Да |
| OrderId |
Уникальный идентификатор платежа в системе theMAP |
Строка (максимум 50 символов) |
Да |
| Amount |
Сумма для разблокировки в минимальных единицах валюты (копейках) |
Цифры, не содержащие десятичных или других разделителей |
Да |
Пример запроса POST:
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'
| Название |
Описание |
Формат |
| Success |
Флаг успешности операции |
true/false |
| OrderId |
Идентификатор платежа в системе MAP |
Соответсвует переданному в запросе |
| NewAmount |
Измененная заблокированная сумма в копейках |
Цифры, не содержащие десятичных или других разделителей |
| ErrCode |
Описание ошибки. Передается пустой, если «Success=true» |
см. коды ошибок |
| ErrMessage |
Опциональный параметр. Дополнительное описание ошибки. Передается пустой, если «Success=true» |
Строка |
| CustomParams |
Параметр является опциональным. Список дополнительных параметров операции |
Соответствует Params, переданному в запросе Block |
| FeePercent |
Параметр является опциональным. Ставка комиссии за эквайринг, в десятых долях от числа |
Число |
| TerminalID |
Параметр является опциональным. Id терминала в системе MAP, по которому фактически выполнена операция |
Число |
| ProcessingResponse |
Параметр является опциональным. Оригинальный отказ эквайера |
Строка |
Пример ответа на успешный запрос:
{
"Success": true,
"OrderId": "TestOrder123",
"NewAmount": 0,
"ErrCode": ""
}
Пример ответа на не успешный запрос:
{
"Success": false,
"OrderId": "TestOrder123",
"NewAmount": 0,
"ErrCode": "AMOUNT_EXCEED"
}