Перейти к основному содержимому

Метод 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"
}'

Параметры ответа

ИмяТипОписание
transactionIdstringИдентификатор транзакции
processingTransactionIdstringИдентификатор транзакции системы процессинга (UZCARD/HUMO)
merchantIdstringИдентификатор мерчанта VIA
amountintegerСумма перевода в тийинах, центах и т.д.
createdAtintegerДата и время создания транзакции в формате Unix Timestamp
statusstringСтатус транзакции:
«SUCCESS» - Успешно
«ERROR» - Ошибка
«REJECT» - Отказано
«PENDING» - Запрос в ожидании
«NEW» - Отправлен новый запрос
«DRAFT» - Запрос на стадии формирования
payedAtintegerДата и время оплаты в формате Unix Timestamp
feeintegerСумма комиссии в тийинах, центах и т.д.
(1/100 часть базовой единицы валюты)
feePercentlongСумма комиссии в процентах
currencystringВалюта:
«UZS» - узбекский сум
eposobjectОбъект данных системы EPOS
epos.merchantIdstringПараметр объекта epos:
Идентификатор мерчанта
epos.terminalIdstringПараметр объекта 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"
}
}
}