Онлайн кредит (Банк БелВЭБ)
Данный метод позволяет оплатить товар или услугу с помощью кредита или рассрочки от Банка БелВЭБ. Кредит может быть оформлен как на один товар, так и на корзину товаров.
Оформление кредита
Процесс оформления заявки на кредит на платёжном виджете
| Шаг | Описание |
| 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. На основании этого статуса торговец получает выплату по транзакции в срок, установленный договором. |
| 13 | Если торговец не инициирует перечисление средств в течение 25 дней, транзакция автоматически переходит в статус failed, кредитный договор аннулируется.Если товар не был отгружен (например, покупатель не принял товар), торговец нажимает Отмена сделки. Отменить кредит можно и по API, отправив запрос на отмену кредита, указав cancel в параметре confirm_type. Транзакция переходит в статус failed, кредитный договор аннулируется. Кредит можно отменить только до его подтверждения. |
Пример уведомления с кодом P.0003
Пример уведомления с кодом P.0003
{
"transaction": {
"uid": "1adea25c-2dad-48ad-971f-a3f070f796f0",
"type": "payment",
"status": "pending",
"amount": 8888,
"currency": "BYN",
"description": "Order description",
"created_at": "2026-05-07T06:30:48Z",
"updated_at": "2026-05-07T06:40:51Z",
"method_type": "belveb_credit",
"receipt_url": "https://merchant.bepaid.by/customer/transactions/1adea25c-2dad-48ad-971f-a3f070f796f0/3208469e6f3c4c40fc9bf69780404faaeffe4c7cec6c37aa4f0806fd77cd9b7c?language=ru",
"payment": {
"status": "pending",
"gateway_id": 6319,
"ref_id": "16774961211129",
"message": "Договор к выдаче",
"bank_code": "7",
"rrn": "28.070526.0001"
},
"belveb_credit": {
"type": "belveb_credit"
},
"customer": {
"device_id": "770a7549cf32f64a898a43f22c803426",
"email": null,
"ip": "178.32.220.27"
},
"manually_corrected_at": null,
"version": 3,
"message": "Договор к выдаче",
"code": "P.0003",
"test": false,
"language": "ru",
"billing_address": {
"device_id": "770a7549cf32f64a898a43f22c803426"
},
"additional_data": {
"cart": {
"positions": [
{
"name": "[FILTERED]",
"amount": 4100,
"quantity": 1,
"top_product": true
},
{
"name": "[FILTERED]",
"amount": 3900,
"quantity": 1,
"top_product": false
}
]
},
"vendor": {
"name": "[FILTERED]",
"token": "[FILTERED]"
},
"browser": {},
"payment_method": {
"type": "alternative"
},
"shipping_amount": 888
},
"smart_routing_verification": {
"status": "successful"
},
"gateway": {
"iframe": false
}
}
}
Вариант запроса без дополнительных параметров
Отправьте запрос на создание токена платежа.
При оформлении кредита на корзину товаров укажите наименования товаров в поле 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"
}
}