Інтеграція платіїної системи Белкарт на сайт
Белкарт — національна платіжна система Беларуси. Карти Белкарт видаються всіма крупними білоруськими банками та є основним платіжним інструментом значної частини населення. Для білоруських інтернет-магазинів прийм карт Белкарт — не опція, а необхідність.
Особливості підключення
Белкарт не надає власний платіжний шлюз для інтернет-приймання. Прийм карт Белкарт в інтернеті здійснюється через банки-еквайєри, що мають сертифікацію платіжної системи. Основні варіанти:
- Беларусбанк (ePay, WebPay) — найпопулярніший еквайєр
- Приорбанк (власний шлюз)
- БСБ Банк — через Webpay.by
- Банк Дабрабыт — прямий еквайринг
При підключенні до будь-якого з цих банків Белкарт буде автоматично включений у список приймаємих карт разом з Visa та Mastercard. Окремої «інтеграції Белкарт» як такої немає — це одна з платіжних схем всередині стандартного еквайрингу.
Підключення через Webpay (БСБ Банк)
Найбільш технічно зрілий варіант для Беларуси. Протокол описаний у документі «Керівництво з інтеграції для інтернет-магазинів» на webpay.by.
function buildWebpayPayment(int $orderId, float $amount): array
{
$storeId = env('WEBPAY_STORE_ID');
$secretKey = env('WEBPAY_SECRET_KEY');
$seed = time();
$wsb_test = env('WEBPAY_TEST', 1);
$total = number_format($amount, 2, '.', '');
// Белкарт приймається автоматично через той же шлюз
// Покупець вибирає тип карти на сторінці Webpay
$signature = md5($seed . $storeId . $orderId . $wsb_test . 'BYN' . $total . $secretKey);
return [
'wsb_storeid' => $storeId,
'wsb_order_num' => $orderId,
'wsb_currency_id'=> 'BYN',
'wsb_test' => $wsb_test,
'wsb_total' => $total,
'wsb_signature' => $signature,
'wsb_seed' => $seed,
'wsb_notify_url' => 'https://example.com/webhook/webpay',
'wsb_return_url' => 'https://example.com/payment/success',
'wsb_fail_url' => 'https://example.com/payment/fail',
'wsb_version' => '2',
'wsb_lang' => 'russian',
'*scart' => '',
];
}
Белкарт-Інтернет vs Белкарт offline
Важливе розходження: звичайна карта Белкарт (з магнітною полосою) не може використовуватися для онлайн-платежів. Для інтернет-оплати потребна карта з підтримкою Белкарт-Інтернет (наявність CVV2 або аналога). Більшість карт, виданих з 2018 року, підтримують це. Клієнти з подібними картами можуть зіткнутися з відмовою — це поведінка на стороні карти, не шлюзу.
3D Secure для Белкарт
Белкарт підтримує власний протокол 3D Secure, який називається Белкарт-3D. Він працює аналогічно Verified by Visa / Mastercard SecureCode — додаткове підтвердження через код з SMS або push. Банки-еквайєри включають його автоматично.
Якщо платіжна сторінка банку не ініціює 3DS для карти Белкарт — це проблема налаштування на стороні банку, не інтеграції.
Визначення типу карти на клієнті
Для покращення UX можна визначати тип карти за першими цифрами BIN та показувати логотип:
function detectCardScheme(cardNumber: string): 'visa' | 'mastercard' | 'belcart' | 'unknown' {
const num = cardNumber.replace(/\s/g, '');
// Белкарт: BIN починається з 9112, 9560, 6090
if (/^(9112|9560|6090)/.test(num)) return 'belcart';
if (/^4/.test(num)) return 'visa';
if (/^5[1-5]/.test(num)) return 'mastercard';
return 'unknown';
}
Актуальний список BIN-діапазонів Белкарт публікує НБРБ; базові діапазони перечислені вище, але список може розширюватися.
Відображення логотипу
Белкарт надає офіційний комплект логотипів на сайті belcart.com. Використання логотипу регульоване умовами платіжної системи — розміщувати його обов'язково при приймі карт Белкарт.
<div class="payment-logos">
<img src="/images/payment/visa.svg" alt="Visa" />
<img src="/images/payment/mastercard.svg" alt="Mastercard" />
<img src="/images/payment/belcart.svg" alt="Белкарт" />
<img src="/images/payment/mir.svg" alt="МІР" />
</div>
Часові терміни
Підключення інтернет-еквайрингу через білоруський банк з підтримкою Белкарт займає 5–10 робочих днів: укладення договору, перевірка сайту службою безпеки банку, налаштування терміналу. Тестування — 1–2 дні. Всього повний цикл — 7–14 робочих днів від подання заявки до першого реального платежу.