Метод 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» - узбекский сум |
| note | string | Текст примечания, заметки и т.д. |
| 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"
},
}'
Параметры ответа
| Имя | Тип | Описание |
|---|---|---|
| verifyId | string | Идентификатор кода верификации |
Пример ответа в случае успеха
{
"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"
}
}
}