Онлайн кредит (Банк БелВЭБ)
Данный метод позволяет оплатить товар или услугу с помощью кредита или рассрочки от Банка БелВЭБ. Кредит может быть оформлен как на один товар, так и на корзину товаров.
Оформление кредита
Процесс оформления заявки на кредит на платёжном виджете
| Шаг | Описание |
| 1 | Торговец инициирует платёжный виджет, используя токен платежа. Или торговец делает запрос на создание токена платежа и перенаправляет покупателя на redirect_url из ответа. |
| 2 | Покупатель выбирает на виджете опцию оплаты с помощью кредита или рассрочки (Частками). |
| 3 | На виджете отображаются доступные варианты кредитования. |
| 4 | Покупатель выбирает вариант кредитования. |
| 5 | Покупатель перенаправляется на сайт МСИ (Межбанковская система идентификации) для аутентификации. |
| 6 | В личном кабинете торговца отображается транзакция в статусе pending. |
| 7 | После успешной аутентификации покупатель перенаправляется на сайт банка. |
| 8 | Покупатель вводит необходимые данные и нажимает Подписать документы, затем вводит код подтверждения, отправленный на его номер телефона. |
| 9 | Покупателю на сайте банка отображается номер кредитного договора. Покупатель вводит ещё один код подтверждения, отправленный банком на его номер телефона. Кредитный договор оформляется только после отгрузки товара торговцем. |
| 10 | В личном кабинете торговца у транзакции появляется метка Требуется отгрузка и код статуса P.0003. |
| 11 | Торговец отгружает покупателю товар в течение 1–25 дней. |
| 12 | После отгрузки товара торговец нажимает Перечислить средства > Подтвердить на странице детальной информации о транзакции. Подтвердить кредит можно и по API, отправив запрос на отгрузку товара, указав confirm в параметре confirm_type. В личном кабинете торговца у транзакции появляется метка Перечисление средств и код статуса P.0004. В течение 5 минут транзакция переходит в статус successful. На счёт торговца в течение пяти рабочих дней после заключения кредитного договора (чаще в тот же рабочий день) отправляется сумма кредита.Если торговец не инициирует перечисление средств в течение 25 дней, транзакция автоматически переходит в статус failed. |
| 13 | Если товар не был отгружен (например, покупатель не принял товар), торговец нажимает Отмена сделки. Отменить кредит можно и по API, отправив запрос на отмену кредита, указав cancel в параметре confirm_type. Транзакция переходит в статус failed. Кредит можно отменить только до его подтверждения. |
Вариант запроса без дополнительных параметров
Отправьте запрос на создание токена платежа.
При оформлении кредита на корзину товаров укажите наименования товаров в поле order.description, а в поле amount — итоговую сумму за все товары. Обратите внимание, что в таком случае все товары будут отражены в чеке как одна позиция.
Пример запроса без дополнительных параметров: наименования товаров, оформляемых в кредит, перечислены в order.description, общая сумма за корзину товаров указана в order.amount.
{
"checkout": {
"transaction_type": "payment",
"attempts": 3,
"settings": {
"language": "ru"
},
"order": {
"currency": "BYN",
"amount": 5724,
"description": "Товар 1, Товар 2"
}
}
}
Вариант запроса с дополнительными параметрами (cart, shipping_amount)
Отправьте запрос на создание токена платежа.
Для оформления кредита на корзину товаров добавьте секцию order.additional_data.cart с информацией о товарах.
Если кредит оформляется также и на сумму доставки, передайте сумму доставки в объекте order.additional_data.shipping_amount.
Если товаров несколько, и передан объект additional_data.cart, то сумма значений amount по всем позициям вместе с shipping_amount должны быть равны значению основного параметра amount в запросе на создание токена.
Пример запроса с дополнительными параметрами: информация о товарах передана в order.additional_data.cart
{
"checkout": {
"transaction_type": "payment",
"attempts": 3,
"settings": {
"language": "ru"
},
"customer": {
"email": "john@example.com",
"phone": "375291111111"
},
"payment_method": {
"types": [
"belveb_credit"
]
},
"order": {
"currency": "BYN",
"amount": 5724,
"description": "Описание заказа",
"additional_data": {
"shipping_amount": 24,
"cart": {
"positions": [
{
"name": "Товар 1",
"amount": 1200,
"quantity": 2
},
{
"name": "Товар 2",
"amount": 1100,
"quantity": 3
}
]
}
}
}
}
}
Основные параметры запроса перечислены в таблице ниже:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Запрос на отгрузку товара / отмену кредита
POST https://api.bepaid.by/beyag/transactions/{uid}/confirm
|
|||||||
Пример запроса
{
"request": {
"confirm_type": "confirm"
}
}
Пример ответа
{
"transaction": {
"parent_uid": "81f8ab21-ca4f-4de8-9775-b9c6fad2b010",
"type": "confirm",
"status": "successful",
"message": "Договор к выдаче",
"created_at": "2026-04-07T13:04:31.189+00:00",
"amount": 6500,
"currency": "BYN"
}
}