Отметим: когда клиент пытается оплатить заказ картой Белкарт, но платёжная страница банка выдаёт ошибку — это не баг, а отсутствие правильной интеграции. Мы настраиваем приём карт Белкарт через банки-эквайеры Беларуси, чтобы платежи проходили без сбоев. Наш опыт — 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 рабочих дней. Свяжитесь с нами для предварительной консультации.