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

Метод pay

URL: POST - /partner/merchant/confirm/pay

Метод позволяет отправить запрос на оплату услуги мерчанта VIA c банковской карты клиента. При успешной обработке запроса система возвращает уникальный идентификатор разового кода верификации. Разовый код верификации будет отправлен клиенту в виде SMS сообщения. Для подтверждения оплаты, партнер должен отправить полученный идентификатор и код верификации методом merchant/confirm/pay/verify.

Параметры Заголовков

СвойствоТипОписание
client-id *авторизацияУникальный идентификатор партнера
client-secret *авторизацияУникальный ключ аутентификации к API VIA

Параметры запроса

ИмяТипОписание
merchantId *stringИдентификатор мерчанта VIA
card *objectОбъект данных банковской карты
card.pan *stringПараметр объекта card: Номер банковской карты клиента
card.expiry *stringПараметр объекта card: Срок действия банковской карты клиента
externalId *stringУникальный идентификатор запроса партнера
amount *integerСумма оплаты в тийинах, центах и т.д. (1/100 часть базовой единицы валюты)
currency *stringВалюта:
«UZS» - узбекский сум
notestringТекст примечания, заметки и т.д.
accounts *stringОбъект данных относительно услуг мерчанта.
Параметры и их значения объекта accounts определяется в зависимости от услуги мерчанта, на которую осуществляется платеж.
Например:
Для оплаты услуги мобильного оператора отправляется номер телефона.

Пример запроса

curl POST '/partner/merchant/confirm/pay' \
--header 'client-id: system' \
--header 'client-secret: system123' \
--data '{
"merchantId": "mrt_qwegFC1lHGaAzJIRphv4LdU10zX",
"card": {
"pan": "8600490100151968",
"expiry": "1023"
},
"externalId": "test_1"
"amount": 10000,
"currency": "UZS",
"note": "",
"accounts": {
"account": "123123"
},
}'

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

ИмяТипОписание
verifyIdstringИдентификатор кода верификации

Пример ответа в случае успеха

{
"verifyId": "trx_2VQGS1Eeu4DNsfuKxbFO1vftNy4"
}

Пример ответа в случае ошибки

{
"status": {
"code": "1234",
"message": "Ошибка при выполнении запроса"
},
"error": {
"path": "URL Path",
"message": {
"uz": "Error message in Uzbek",
"ru": "Error message in Russian",
"en": "Error message in English"
}
}
}