Метод verify
URL: POST - /partner/merchant/confirm/pay/verify
Метод позволяет отправить разовый кода верификации для подтверждения оплаты услуги мерчанта VIA c банковской карты клиента.
При отправке запроса на оплату услуги мерчанта методом merchant/confirm/pay, система возвращает уникальный идентификатор разового кода верификации. Разовый код верификации будет отправлен клиенту в виде SMS сообщения.
Для подтверждения оплаты, партнер должен отправить полученный идентификатор и разовый код верификации методом merchant/confirm/pay/verify.
Параметры Заголовков
| Свойство | Тип | Описание |
|---|---|---|
| client-id * | авторизация | Уникальный идентификатор партнера |
| client-secret * | авторизация | Уникальный ключ аутентификации к API VIA |
Параметры запроса
| Имя | Тип | Описание |
|---|---|---|
| verifyId * | string | Идентификационный номер для подтверждения |
| verifyCode * | string | Код подтверждения |
Пример запроса
curl POST '/partner/merchant/confirm/pay/verify' \
--header 'client-id: system' \
--header 'client-secret: system123' \
--data '{
"verifyId": "trx_2VQGS1Eeu4DNsfuKxbFO1vftNy4",
"verifyCode": "005646"
}'
Параметры ответа
| Имя | Тип | Описание |
|---|---|---|
| transactionId | string | Идентификатор транзакции |
| processingTransactionId | string | Идентификатор транзакции системы процессинга (UZCARD/HUMO) |
| merchantId | string | Идентификатор мерчанта VIA |
| amount | integer | Сумма перевода в тийинах, центах и т.д. |
| createdAt | integer | Дата и время создания транзакции в формате Unix Timestamp |
| status | string | Статус транзакции: «SUCCESS» - Успешно «ERROR» - Ошибка «REJECT» - Отказано «PENDING» - Запрос в ожидании «NEW» - Отправлен новый запрос «DRAFT» - Запрос на стадии формирования |
| payedAt | integer | Дата и время оплаты в формате Unix Timestamp |
| fee | integer | Сумма комиссии в тийинах, центах и т.д. (1/100 часть базовой единицы валюты) |
| feePercent | long | Сумма комиссии в процентах |
| currency | string | Валюта: «UZS» - узбекский сум |
| epos | object | Объект данных системы EPOS |
| epos.merchantId | string | Параметр объекта epos: Идентификатор мерчанта |
| epos.terminalId | string | Параметр объекта epos: Идентификатор терминала мерчанта |
Пример ответа в случае успеха
{
"transactionId": "trx_2VQGS1Eeu4DNsfuKxbFO1vftNy4",
"processingTransactionId": "010964369832",
"merchantId": "mrt_2V4M5svbNoQ68tB0ul8LoLWJOZQ",
"amount": 100,
"createdAt": 1694760886762,
"status": "SUCCESS",
"payedAt": 1694760902483,
"fee": 0,
"feePercent": 0.0,
"currency": "UZS",
"epos": {
"merchantId": "11111111111",
"terminalId": "22222222"
}
}
Пример ответа в случае ошибки
{
"status": {
"code": "1234",
"message": "Ошибка при выполнении запроса"
},
"error": {
"path": "URL Path",
"message": {
"uz": "Error message in Uzbek",
"ru": "Error message in Russian",
"en": "Error message in English"
}
}
}