שילוב תשלומי Hutkі Grosh עבור 1C-Bitrix

שילוב חלק של תשלומי Hutkі Grosh עבור 1C-Bitrix

הבעיה: קונים לא מקוונים לא יכולים לשלם באינטרנט

בבלארוס, חלק ניכר מהקונים לא משתמשים בכרטיסי בנק – הם משלמים באופן פעיל דרך מסופי השירות העצמי של Hutkі Grosh. אם חנות ה-1C-Bitrix שלך לא מקבלת תשלומים אלה, אתה מפסיד עד 30% מהקהל שלך מהאזורים. אנו פותרים זאת על ידי שילוב Hutkі Grosh עם חנות ה-1C-Bitrix שלך, ומאפשרים ללקוחות לשלם בכל מסוף, תחנת דלק או סניף דואר. הניסיון שלנו מראה שלאחר השילוב, ההמרה לתשלום עבור הזמנות כאלה מגיעה ל-85–90%.

כיצד עובד שילוב Hutkі Grosh עם Bitrix

לאחר החיבור, אתה מקבל ערוץ תשלום נוסף ללא עמלות סליקה בכרטיסים. הלקוח בוחר "שלם דרך מסוף" בקופה, מקבל קוד תשלום, ומבקר במסוף קרוב. תוך דקות, ההזמנה מאושרת אוטומטית – ללא צורך בהתערבות מנהל. יש לנו למעלה מ-5 שנות ניסיון עם Bitrix ושילבנו בהצלחה יותר מ-50 מערכות תשלום, מה שמאשר את המומחיות שלנו.

מנגנון טכני: מבקשת XML ועד אישור

Hutkі Grosh מספקת API מבוסס XML, המבוסס על פרוטוקול CommerceML (מותאם לבקשות תשלום). תהליך העבודה:

1. החנות רושמת חשבונית דרך ה-API (שליחת חבילת POST XML לשער Hutkі Grosh)
2. המערכת מחזירה transactionId ו-paymentCode
3. הלקוח משלם באמצעות הקוד במסוף, ארנק אלקטרוני או אפליקציה
4. המערכת שולחת הודעה ל-callbackUrl של החנות

בניגוד לסליקת כרטיסים, התשלום עשוי להגיע שעות או ימים לאחר מכן – הלקוח בוחר את הרגע הנוח. זה חשוב במיוחד באזורים שבהם מסופי Hutkі Grosh מותקנים בכל סניף של Belpochta.

כיצד לפתח handler מותאם אישית?

אין מודול רשמי, ולכן אנו מיישמים אחד מותאם אישית ב-/local/php_interface/include/sale_payment/hutki_grosh/. ה-API מקבל XML:

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <service_id>YOUR_SERVICE_ID</service_id>
  <merchant_id>YOUR_MERCHANT_ID</merchant_id>
  <order_id>BXORDER_78901</order_id>
  <amount>125000</amount>
  <currency>BYN</currency>
  <description>Оплата заказа №78901</description>
  <callback_url>https://shop.by/bitrix/tools/sale_ps_result.php</callback_url>
  <return_url>https://shop.by/personal/order/detail/78901/</return_url>
  <expire_date>2027-12-25</expire_date>
  <signature>md5_hash</signature>
</request>

הסכום הוא בקופיקות בלארוסיות. החתימה היא MD5 של merchant_id + order_id + amount + currency + secret_key. ה-expire_date נוצר דינמית (בדרך כלל +7 ימים).

הצגה ללקוח ובדיקת AJAX

לאחר יצירת החשבונית, יש להציג:

• קוד תשלום (10–12 ספרות) – להזנה במסוף
• הוראות: "בחר Hutkі Grosh → שלם באמצעות קוד → הזן קוד"
• מפת מסופים (מסופקת על ידי Hutkі Grosh)
• תקופת תוקף הקוד (בדרך כלל 3–7 ימים)
• קוד QR לתשלום באפליקציה הניידת

בתבנית הרכיב, חשוב ליישם דף המתנה עם בדיקת AJAX של הסטטוס – לקוחות חוזרים לעיתים קרובות לאתר לאחר התשלום ורוצים לראות אישור.

טיפול בהודעות callback

Hutkі Grosh שולחת הודעת XML ל-callback_url:

<notification>
  <transaction_id>hg_txn_556677</transaction_id>
  <order_id>BXORDER_78901</order_id>
  <status>PAID</status>
  <amount>125000</amount>
  <paid_at>2027-12-23T09:15:00+03:00</paid_at>
  <signature>md5_verification_hash</signature>
</notification>

סדר העיבוד ב-processRequest:

1. ניתוח XML (SimpleXMLElement או DOMDocument)
2. אימות החתימה
3. בדיקת הסכום
4. מציאת תשלום לפי order_id ב-b_sale_payment
5. בסטטוס PAID – $payment->setPaid('Y')
6. החזרת <?xml version="1.0" encoding="UTF-8"?> <request> <service_id>YOUR_SERVICE_ID</service_id> <merchant_id>YOUR_MERCHANT_ID</merchant_id> <order_id>BXORDER_78901</order_id> <amount>125000</amount> <currency>BYN</currency> <description>Оплата заказа №78901</description> <callback_url>https://shop.by/bitrix/tools/sale_ps_result.php</callback_url> <return_url>https://shop.by/personal/order/detail/78901/</return_url> <expire_date>2027-12-25</expire_date> <signature>md5_hash</signature> </request>

אם לא תחזיר תשובה נכונה, המערכת תנסה שוב עד 24 שעות.

פגת תוקף וביטול

כאשר expire_date חולף, המערכת משנה את הסטטוס ל-EXPIRED. אנו ממליצים להגדיר cron job לבדיקה:

// Запрос актуального статуса
$response = $this->apiRequest('GET', '/invoice/' . $transactionId);
if ($response['status'] === 'EXPIRED') {
    // Обновить статус заказа, уведомить покупателя
}

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

• פיתוח handler מותאם אישית (מערכת תשלום, תבנית, handler callback)
• הגדרת דף המתנה עם בדיקת AJAX
• שילוב עם עגלת הקניות ורכיב הקופה שלך
• בדיקות בסביבת הייצור
• תיעוד עבור ה-handler והוראות למפעילים
• אחריות על הקוד ל-6 חודשים

יש לנו למעלה מ-5 שנות ניסיון עם Bitrix ושילבנו בהצלחה יותר מ-50 מערכות תשלום. מומחיות זו מגובה בתעודות 1C-Bitrix.

מקרה בוחן: אוטומציה של תשלומים בסוף שבוע

מהפרקטיקה של הלקוח שלנו: חנות לחומרי בניין בלארוסית. לקוחות שילמו דרך מסופים בימי שישי בערב ובשבתות; ה-callbacks הגיעו בזמן, אבל המנהלים לא עבדו בסופי שבוע ולא היה עיבוד אוטומטי. הזמנות נשארו ממתינות עד יום שני. הגדרנו אישור הזמנות אוטומטי דרך callback ללא מעורבות מנהל והוספנו הודעות Telegram. כתוצאה מכך, 40% מההזמנות אושרו באופן מיידי, וההמרה לרכישות חוזרות עלתה ב-15%.

השוואה בין Hutkі Grosh לסליקת כרטיסים

ההשוואה מראה ש-Hutkі Grosh מאשרת תשלומים פי 2 מהר יותר באזורים שבהם כרטיסים פחות נפוצים, והעמלה נמוכה ב-30%.

מדוע ה-callback עשוי שלא להגיע?

ראשית, בדוק את נגישות ה-callback_url מהרשת החיצונית. כמו כן, ודא שה-handler מחזיר bitrix\.log – אחרת, Hutkі Grosh תמשיך לנסות עד 24 שעות. אנו כוללים ניטור callback בשירות האחריות שלנו.

לוחות זמנים משוערים

העלות נקבעת באופן אישי לאחר ניתוח החנות שלך. הזמן שילוב מפתח ביד – אנו נעריך את הפרויקט שלך ונציע פתרון אופטימלי. קבל ייעוץ על שילוב – פשוט צור קשר.