Онлайн кредит (Банк БелВЭБ)
Данный метод позволяет оплатить товар или услугу с помощью кредита или рассрочки от Банка БелВЭБ. Кредит может быть оформлен как на один товар, так и на корзину товаров.
Процесс оформления заявки на кредит на платёжном виджете
1) Торговец инициирует платёжный виджет, используя токен платежа. Или торговец делает запрос на создание токена платежа и перенаправляет покупателя на redirect_url из ответа.
2) Покупатель выбирает на виджете опцию оплаты с помощью кредита или рассрочки (Частками).
3) На виджете отображаются доступные варианты кредитования/рассрочки.
4) Покупатель выбирает вариант кредитования.
5) Покупатель перенаправляется на страницу для аутентификации в системе МСИ (Межбанковская система идентификации).
6) В личном кабинете торговца отображается транзакция в статусе pending.
7) После успешной аутентификации покупатель перенаправляется на сайт банка.
8) Покупатель вводит необходимые данные и нажимает Подписать документы.
9) Покупателю на сайте банка отображается кредитный договор. Покупатель вводит ещё один код подтверждения, отправленный банком на его номер телефона. Кредитный договор начинает действовать после перечисления средств торговцу.
10) В личном кабинете торговца у транзакции появляется метка Требуется отгрузка и код статуса P.0003. Также торговец получит уведомление с этим статусом.
11) Торговец отгружает покупателю товар в течение 1–24 дней.
12) После отгрузки товара торговец нажимает Перечислить средства > Подтвердить на странице детальной информации о транзакции.
Подтвердить кредит можно и по API, отправив запрос на отгрузку товара, указав confirm в параметре confirm_type.
13) В личном кабинете торговца у транзакции появляется метка Перечисление средств и код статуса P.0004.
14) В течение 5 минут транзакция переходит в статус successful. На основании этого статуса торговец получает выплату по транзакции в срок, установленный договором.
15) Если торговец не инициирует перечисление средств в течение 24 дней, транзакция автоматически переходит в статус failed, кредитный договор аннулируется.
16) Если товар не был отгружен (например, покупатель не принял товар), торговец нажимает Отмена сделки.
Отменить кредит можно и по API, отправив запрос на отмену кредита, указав cancel в параметре confirm_type.
17) Транзакция переходит в статус 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"
}
}