Інтеграція 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, скасування, помилки
• Навчання операторів роботі з новим типом оплати
• Документацію з підтримки та типові проблеми

Терміни

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

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