Відзначимо: коли клієнт намагається оплатити замовлення карткою Белкарт, але платіжна сторінка банку видає помилку — це не баг, а відсутність правильної інтеграції. Ми налаштовуємо прийом карток Белкарт через банки-еквайри Білорусі, щоб платежі проходили без збоїв. Наш досвід — 7+ років інтеграції платіжних систем, понад 50 успішних проєктів з Белкарт. У 95% випадків платіж проходить з першої спроби після нашого налаштування. Середня конверсія платежів через Белкарт становить 94%. Зв'яжіться з нами для консультації та отримайте детальний план інтеграції.
Вибір банку-еквайра
Які банки приймають Белкарт?
Белкарт — національна платіжна система Білорусі. Для білоруських інтернет-магазинів прийом карток Белкарт — не опція, а необхідність. Ми допомагаємо обрати оптимального еквайра та налаштувати платіжний шлюз за 5–10 днів.
Белкарт не надає власний платіжний шлюз для інтернет-прийому. Прийом карток Белкарт в інтернеті здійснюється через банки-еквайри, що мають сертифікацію платіжної системи. Основні варіанти:
- Беларусбанк (ePay, WebPay) — найпопулярніший еквайр
- Пріорбанк (власний шлюз)
- БСБ Банк — через Webpay.by
- Банк Дабрабыт — прямий еквайринг
При підключенні до будь-якого з цих банків Белкарт автоматично буде включений до списку карток, що приймаються, поряд із Visa та Mastercard. Окремої інтеграції Белкарт як такої немає — це одна з платіжних схем усередині стандартного еквайрингу.
Порівняння банків-еквайрів
| Банк | Платіжний шлюз | Комісія | Швидкість обробки |
|---|---|---|---|
| Беларусбанк | ePay, WebPay | від 1.8% | стандартна |
| Пріорбанк | Власний шлюз | від 2.0% | стандартна |
| БСБ Банк | Webpay.by | від 1.5% | на 30% швидше ePay |
| Банк Дабрабыт | Прямий еквайринг | індивідуально | висока |
Для вибору відповідного банку зв'яжіться з нами — ми проаналізуємо ваш трафік та допоможемо заощадити до 20% на комісії.
Технічна інтеграція
Як підключити Белкарт до інтернет-магазину?
Найбільш технічно зрілий варіант для Білорусі — Webpay від БСБ Банку. Протокол описаний у документі «Керівництво з інтеграції для інтернет-магазинів» на webpay.by. Підключення включає наступні кроки:
- Укладення договору з банком-еквайром.
- Отримання merchant ID та секретного ключа.
- Налаштування платіжної форми на сайті.
- Тестування в пісочниці.
- Перехід у продакшен.
Приклад коду формування запиту до Webpay (PHP):
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' => '', ]; } Налагодження та діагностика
Чому картка Белкарт може не пройти?
Важлива відмінність: звичайна картка Белкарт із магнітною смугою не може використовуватися для онлайн-платежів. Для інтернет-оплати потрібна картка з підтримкою Белкарт-Інтернет (наявність CVV2 або аналога). Більшість карток, випущених за останні роки, підтримують це. Клієнти зі старими картками можуть зіткнутися з відмовою — це поведінка на стороні картки, не шлюзу. Додатково: платіж може блокуватися, якщо не налаштовано 3D Secure. Ми допомагаємо діагностувати такі кейси.
Як працює 3D Secure для Белкарт?
Белкарт підтримує власний протокол 3D Secure — Белкарт-3D. Він працює аналогічно Verified by Visa або Mastercard SecureCode: додаткове підтвердження через код із SMS або push. Банки-еквайри включають його автоматично. Якщо платіжна сторінка банку не ініціює 3DS для Белкарт-картки — це проблема налаштування на стороні банку, не інтеграції. При тестуванні ми обов'язково перевіряємо проходження 3DS.
Як перевірити, чи підтримує картка 3D Secure?
Зверніться до банку-емітента або спробуйте здійснити тестовий платіж із карткою, що свідомо підтримує 3DS. Якщо 3DS не викликається, перевірте налаштування термінала.Типові помилки при інтеграції
| Помилка | Причина | Рішення |
|---|---|---|
| Платіж не проходить | Картка без CVV2 | Перевірити тип картки |
| 3DS не викликається | Налаштування банку | Звернутися до банку |
| Signature mismatch | Невірний секретний ключ | Перевірити конфіг |
Додаткові можливості
Визначення типу картки на клієнті та відображення логотипу
Для покращення 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 тестових транзакцій.
- Консультації щодо 3D Secure та лімітів.
- Допомогу в проходженні перевірки безпеки банку.
Терміни
Підключення інтернет-еквайрингу через білоруський банк з підтримкою Белкарт займає 5–10 робочих днів: укладення договору, перевірка сайту службою безпеки банку, налаштування термінала. Тестування — 1–2 дні. Повний цикл — 7–14 робочих днів від подачі заявки до першого реального платежу.
Якщо вам потрібна інтеграція Белкарт, звертайтеся — ми підберемо оптимального еквайра та налаштуємо платіжний шлюз за 5–10 робочих днів. Зв'яжіться з нами для попередньої консультації.