Интеграция платёжной системы Белкарт на сайт
Белкарт — национальная платёжная система Беларуси. Карты Белкарт выпускаются всеми крупными белорусскими банками и являются основным платёжным инструментом значительной части населения. Для белорусских интернет-магазинов приём карт Белкарт — не опция, а необходимость.
Особенности подключения
Белкарт не предоставляет собственный платёжный шлюз для интернет-приёма. Приём карт Белкарт в интернете осуществляется через банки-эквайеры, имеющие сертификацию платёжной системы. Основные варианты:
- Беларусбанк (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 рабочих дней от подачи заявки до первого реального платежа.