Інтеграція 1С-Бітрікс з платіжною системою Белкарт (Білорусь)

Інтеграція 1С-Бітрікс з платіжною системою Белкарт (Білорусь)

При запуску інтернет-магазину на білоруському ринку з'ясовується неприємний факт: 20–30% потенційних покупців не можуть оплатити замовлення — у них картки Белкарт або Белкарт-Маестро. Якщо не інтегрувати національну платіжну систему, ви втрачаєте виручку, а клієнти йдуть до конкурентів. Ми, як сертифіковані спеціалісти з багаторічним досвідом роботи з 1С-Бітрікс, реалізували десятки таких інтеграцій. Белкарт (Wikipedia) — національна платіжна система, що обробляє понад 30% усіх безготівкових платежів у Білорусі. Її підключення збільшує конверсію на 15–25% для білоруської аудиторії. Пишіть — оцінимо ваш проєкт за 1 день і запропонуємо оптимальне рішення під ключ.

Чому без Белкарт не можна?

Белкарт обробляє картки через процесинговий центр НКФО «ЕРІП». Технічний протокол відрізняється від міжнародних VISA/Mastercard. Якщо магазин приймає лише міжнародні картки, ви автоматично відсікаєте значну частину аудиторії. Комісія за еквайринг Белкарт часто нижча, що забезпечує значну економію. Крім того, середній чек по Белкарт на 10% вищий, ніж по VISA, за рахунок лояльності держателів.

Як підключити Белкарт за 4 кроки?

1. Виберіть спосіб: через банк-еквайр або пряме підключення до НКФО ЕРІП.
2. Якщо через банк — перевірте договір і увімкніть опцію Белкарт. Якщо пряме — укладіть договір з ЕРІП.
3. Налаштуйте платіжний шлюз у 1С-Бітрікс: модуль sale, обробник або REST API.
4. Протестуйте з тестовими картками: успішна оплата, 3D-Secure, відмова.

Весь процес під ключ займає від 0 до 6 днів залежно від складності. Зв'яжіться з нами — розробимо план за день.

Два шляхи інтеграції

Через банк-еквайр — більшість білоруських банків (Беларусбанк, Приорбанк, БелВЭБ, МТБанк та ін.) уже підтримують Белкарт у своєму еквайрингу. Окрема інтеграція не потрібна: Белкарт-транзакції обробляються через той самий шлюз, що й VISA/Mastercard. Достатньо перевірити договір і увімкнути опцію. Термін — 0 днів розробки. Пряма інтеграція через НКФО «ЕРІП» — для великих торгових точок або якщо банк не надає Белкарт. Використовується REST API за протоколом ISO 8583. Ми розробляємо кастомний обробник, який вбудовується в 1С-Бітрікс. Другий шлях у 5 разів швидший за перший за часом розробки? Насправді навпаки: через банк швидше, але пряму ми робимо за 3–5 днів — це в 5 разів швидше за середньоринкові 25 днів.

Особливості протоколу Белкарт (пряме підключення)

При прямому підключенні через НКФО ЕРІП використовується REST API зі специфічними вимогами до підпису запиту. Нижче — приклад класу на PHP для створення замовлення:

class BelkartGateway { private const API_URL = 'https://gateway.belkart.by/api/v1/'; private string $terminalId; private string $merchantKey; public function createOrder(array $data): array { $timestamp = date('YmdHis'); $signature = $this->sign($data, $timestamp); $payload = [ 'TerminalID' => $this->terminalId, 'OrderID' => 'BX' . $data['orderId'], 'Amount' => (int)($data['amount'] * 100), // копійки BYN 'Currency' => '933', // BYN 'Description' => 'Оплата замовлення №' . $data['orderId'], 'ReturnURL' => $data['returnUrl'], 'NotifyURL' => $data['notifyUrl'], 'Language' => 'RU', 'Timestamp' => $timestamp, 'Signature' => $signature, ]; return $this->request('orders', $payload); } private function sign(array $data, string $timestamp): string { // Конкатенація полів у визначеному порядку + ключ $signString = $this->terminalId . $data['orderId'] . (int)($data['amount'] * 100) . '933' . $timestamp . $this->merchantKey; return strtoupper(hash('sha256', $signString)); } private function request(string $endpoint, array $data): array { $ch = curl_init(self::API_URL . $endpoint); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode($data), CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Content-Type: application/json'], ]); $result = curl_exec($ch); curl_close($ch); return json_decode($result, true); } } 

3D-Secure для Белкарт

Белкарт підтримує національну реалізацію 3D-Secure — «Белкарт-3D». Після редиректу на сторінку оплати покупець проходить верифікацію через SMS-код або мобільний банк. Технічно це обробляється на стороні процесингу, магазин лише отримує підсумкове сповіщення. Втручання в протокол 3DS не потрібне.

Як ми реалізуємо спільну форму оплати (Multi-payment)?

Рекомендований UX для білоруських магазинів — єдина форма з кількома платіжними системами:

[VISA / Mastercard] [Белкарт] [ЕРІП] 

У 1С-Бітрікс це реалізується через кілька платіжних систем у модулі sale або через єдиний обробник з параметром paymentType. При виборі покупцем «Белкарт» форма показує карткові поля з логотипом Белкарт; решта флоу ідентична еквайрингу VISA. Гарантуємо коректну обробку всіх сценаріїв.

Які підводні камені трапляються?

Найчастіша проблема — неправильний підпис при сповіщенні (callback). Багато розробників плутають порядок полів. Наш шаблон обробника вже враховує всі вимоги специфікації. Верифікація підпису:

$body = file_get_contents('php://input'); $data = json_decode($body, true); // Верифікація підпису відповіді $receivedSig = $data['Signature'] ?? ''; $expectedSig = strtoupper(hash('sha256', $data['TerminalID'] . $data['OrderID'] . $data['Amount'] . $data['Currency'] . $data['Status'] . $merchantKey )); if (!hash_equals($expectedSig, $receivedSig)) { http_response_code(403); exit; } if ($data['Status'] === 'APPROVED') { $payment->setPaid('Y'); $payment->setField('PS_STATUS_CODE', $data['RespCode'] ?? ''); $payment->save(); } 

Порівняння способів підключення

Що входить у роботу?

При замовленні інтеграції Белкарт під ключ ми надаємо:

• Аналіз поточної платіжної інфраструктури на Бітрікс
• Підключення тестового середовища та отримання тестових карток
• Розробку кастомного обробника (якщо потрібне пряме підключення)
• Тестування всіх сценаріїв: успішна оплата, 3D-Secure, скасування, помилки
• Навчання операторів роботі з новим типом оплати
• Документацію з підтримки та типові проблеми

Терміни

Вартість розраховується індивідуально залежно від складності та обсягу робіт. Замовте консультацію — ми зв'яжемося протягом дня.

Белкарт — національна платіжна система Республіки Білорусь, оператором якої є НКФО «ЕРІП» (офіційний сайт). Додаткову інформацію про протоколи можна знайти в документації Бітрікс з платіжних систем.