שילוב 1C-Bitrix עם מערכת התשלומים Belkart (בלארוס)

שילוב 1C-Bitrix עם מערכת התשלומים Belkart (בלארוס)

בהשקת חנות מקוונת בשוק הבלארוסי, מגלים במהירות עובדה לא נעימה: 20–30% מהקונים הפוטנציאליים לא יכולים לשלם—הם מחזיקים בכרטיסי Belkart או Belkart-Maestro. אם לא משלבים את מערכת התשלומים הלאומית, מפסידים הכנסות, ולקוחות עוברים למתחרים. כמומחים מוסמכים עם ניסיון של למעלה מעשור עם 1C-Bitrix, השלמנו עשרות אינטגרציות כאלה. Belkart (ויקיפדיה) מעבדת יותר מ-30% מכל התשלומים הלא-מזומנים בבלארוס. הוספתה מעלה את שיעור ההמרה ב-15–25% עבור קהלים בלארוסיים. צרו קשר—נעריך את הפרויקט שלכם תוך יום אחד ונציע את הפתרון הטוב ביותר במפתח פתוח.

למה אי אפשר בלי Belkart

Belkart מעבדת כרטיסים דרך מרכז העיבוד NKFO ERIP. הפרוטוקול הטכני שונה מ-VISA/Mastercard הבינלאומיים. אם החנות שלכם מקבלת רק כרטיסים בינלאומיים, אתם חותכים אוטומטית חלק גדול מהקהל שלכם. העמלה עבור סליקת Belkart לרוב נמוכה יותר—חיסכון של עד 1.5% לעסקה. עבור חנות עם מחזור של 100,000 BYN בחודש, זה עד 1,500 BYN. יתרה מכך, הסל הממוצע עבור Belkart גבוה ב-10% מ-VISA בשל נאמנות בעלי הכרטיסים.

איך לחבר את Belkart ב-4 שלבים

1. בחרו את המסלול: דרך סולק בנקאי או חיבור ישיר ל-NKFO ERIP.
2. אם דרך בנק—בדקו את החוזה והפעילו את אפשרות Belkart. אם ישיר—חתמו על הסכם עם ERIP.
3. הגדירו את שער התשלום ב-1C-Bitrix: מודול 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); } } , handler, או REST API.
4. בדקו עם כרטיסי בדיקה: תשלום מוצלח, 3D-Secure, דחייה.

כל התהליך במפתח פתוח אורך בין 0 ל-6 ימים בהתאם למורכבות. צרו קשר—נכין תוכנית תוך יום.

שני מסלולי אינטגרציה

דרך סולק בנקאי—רוב הבנקים הבלארוסיים (Belarusbank, Priorbank, BelVEB, MTBank וכו') כבר תומכים ב-Belkart בסליקה שלהם. אין צורך באינטגרציה נפרדת: עסקאות Belkart עוברות דרך אותו שער כמו VISA/Mastercard. רק בדקו את החוזה והפעילו את התכונה. מסגרת זמן: 0 ימי פיתוח. אינטגרציה ישירה דרך NKFO ERIP—עבור סוחרים גדולים או אם הבנק שלכם לא מציע Belkart. היא משתמשת ב-REST API על גבי ISO 8583. אנו בונים handler מותאם אישית שמתחבר ל-1C-Bitrix. המסלול השני מהיר פי 5 מהראשון מבחינת זמן פיתוח? למעשה ההפך: דרך בנק מהיר יותר, אבל אינטגרציה ישירה לוקחת לנו 3–5 ימים—פי 5 מהר יותר מהממוצע השוקי של 25 ימים.

פרטי פרוטוקול Belkart (חיבור ישיר)

לחיבור ישיר דרך NKFO ERIP, משתמשים ב-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 עבור Belkart

Belkart תומכת ביישום לאומי של 3D-Secure בשם "Belkart-3D". לאחר הפנייה לדף התשלום, הקונה מאמת באמצעות קוד SMS או בנקאות סלולרית. טכנית, זה מטופל בצד העיבוד; החנות מקבלת רק את ההודעה הסופית. אין צורך בהתערבות בפרוטוקול 3DS.

איך אנו מיישמים טופס תשלום מרובה

חווית המשתמש המומלצת לחנות בלארוסית היא טופס אחד עם מספר מערכות תשלום:

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

ב-1C-Bitrix, זה מיושם באמצעות מספר מערכות תשלום במודול [VISA / Mastercard] [Белкарт] [ЕРИП] או דרך handler יחיד עם פרמטר sale. כשהקונה בוחר "Belkart", הטופס מציג שדות כרטיס עם לוגו Belkart; שאר התהליך זהה לסליקת VISA. אנו מבטיחים טיפול נכון בכל התרחישים.

מלכודות נפוצות

הבעיה הנפוצה ביותר היא חתימה שגויה בהודעת callback. מפתחים רבים מבלבלים את סדר השדות. תבנית ה-handler שלנו כבר מתחשבת בכל דרישות המפרט. אימות חתימה:

$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();
}

השוואת שיטות אינטגרציה

מה כלול בעבודה

בהזמנת אינטגרציית Belkart במפתח פתוח, אנו מספקים:

• ניתוח תשתית התשלומים הנוכחית שלכם ב-Bitrix
• הגדרת סביבת בדיקה וכרטיסי בדיקה
• פיתוח handler מותאם אישית (אם נדרש חיבור ישיר)
• בדיקת כל התרחישים: תשלום מוצלח, 3D-Secure, ביטול, שגיאות
• הדרכת מפעילים על סוג התשלום החדש
• תיעוד לתמיכה ולבעיות נפוצות

מסגרת זמן

תמחור מחושב באופן אישי לפי מורכבות והיקף. צרו קשר לייעוץ—נחזור אליכם תוך יום.

Belkart היא מערכת התשלומים הלאומית של הרפובליקה של בלארוס, המופעלת על ידי NKFO ERIP (אתר רשמי). מידע נוסף על הפרוטוקול ניתן למצוא בתיעוד Bitrix על מערכות תשלום.