Метод confirm
URL: POST - /partner/hold/confirm
Метод позволяет снять нужное количество денежных средств с холдированной (резервированной) суммы.
Параметры Заголовков
| Свойство | Тип | Описание |
|---|---|---|
| client-id * | авторизация | Уникальный идентификатор партнера |
| client-secret * | авторизация | Уникальный ключ аутентификации к API VIA |
Параметры запроса
| Имя | Тип | Описание |
|---|---|---|
| holdId * | string | Идентификатор холдирования |
| amount * | string | Сумма пополнения в тийинах, центах и т.д. (1/100 часть базовой единицы валюты) |
Пример запроса
curl POST '/partner/hold/confirm' \
--header 'client-id: system' \
--header 'client-secret: system123' \
--data '{
"holdId": "phl_2RW4uL2eTpbCqyUjw9mZEOUgVYY",
"amount": 10000
}'
Параметры ответа
| Имя | Тип | Описание |
|---|---|---|
| holdId | string | Идентификатор холдирования |
| status | string | Статус выполнения запроса на холдирование Доступны следующие значения: «NEW» - Запрос на холдирование принят «CREATE_SUCCESS» - Холдирование успешно «CREATE_PENDING» - Холдирование в ожидании «CREATE_ERROR» - Ошибка при холдировании «CONFIRM_SUCCESS» - Снятие средств выполнено успешно «CONFIRM_PENDING» - Процесс снятия средств в ожидании «CONFIRM_ERROR» - Ошибка при снятии средств «CANCEL_SUCCESS» - Отмена средств выполнено успешно «CANCEL_PENDING» - Процесс отмены средств в ожидании «CANCEL_ERROR» - Ошибка при отмене средств «EXPIRED» - срок холдирования истек |
Пример ответа в случае успеха
{
"data": {
"holdId": "phl_2RW4uL2eTpbCqyUjw9mZEOUgVYY",
"status": "CONFIRM_SUCCESS"
}
}
Пример ответа в случае ошибки
{
"status": {
"code": "1234",
"message": "Ошибка при выполнении запроса"
},
"error": {
"path": "URL Path",
"message": {
"uz": "Error message in Uzbek",
"ru": "Error message in Russian",
"en": "Error message in English"
}
}
}