לעתים קרובות נתקלנו במצבים שבהם חנות מקוונת בלארוסית מאבדת עד 30% מההזמנות רק בגלל שרשימת אמצעי התשלום אינה כוללת את ERIP. עבור השוק המקומי, זו לא רק אופציה אלא הכרח — למעלה מ-90% מכלל התשלומים הלא-מזומנים בבלארוס עוברים דרך מרחב המידע והסילוק המאוחד. ללא ERIP, אתם מנתקים חלק משמעותי מהקהל הרגיל לשלם דרך כספומטים, בנקאות אינטרנט או אפליקציות מובייל.
מדוע ERIP משתלם יותר מאשר סליקת כרטיסים
ERIP אינו תשלום מיידי, אלא תהליך: החנות רושמת חשבונית דרך ה-API של סוכן הבנק, הקונה מקבל מספר או קוד QR ומשלם בכל בנק או מסוף. לאחר מכן המערכת שולחת הודעה. עמלת ERIP נמוכה פי 5–10 (0–0.5%) בהשוואה לסליקה (1–3%). זמן אישור התשלום הממוצע הוא 5–15 דקות לאחר התשלום.
השוואה עם סליקה קלאסית:
| פרמטר | סליקת כרטיסים | ERIP |
|---|---|---|
| תשלום מיידי | כן (מקוון) | לא (דורש תשלום ידני) |
| כיסוי קהל | מחזיקי כרטיסים | כל אזרחי בלארוס |
| עמלה | 1–3% | 0–0.5% |
| החזר כספי | סטנדרטי | דרך הבנק, איטי יותר |
מדוע ERIP קריטי למסחר אלקטרוני בלארוסי
לפי הבנק הלאומי, כ-40% מהאוכלוסייה אינו משתמש בכרטיסי בנק לתשלומים מקוונים, ומעדיף מסופים ובנקאות אינטרנט. ERIP מספק גישה לקהל זה, ומגדיל את ההמרה ב-10–20%. חנות מקוונת טיפוסית מקבלת 50–200 עסקאות ERIP ביום, 70% מהן חוזרות.
כיצד אנו מיישמים אינטגרציית ERIP ב-1C-Bitrix
מכיוון שאין API אחיד, האינטגרציה נבנית כמטפל מערכת תשלומים מותאם אישית עבור המודול sale, המותאם ל-API הספציפי של הבנק. מבנה טיפוסי של מטפל ב-/local/php_interface/include/sale_payment/erip/:
handler.php — логика выставления счёта и проверки статуса
.description.php — метаданные, название, иконка
.settings.php — bankApiUrl, merchantId, apiKey, serviceCode
template/ — отображение реквизитов покупателюדוגמה לבקשה לבנק לרישום חשבונית
{
"merchantId": "YOUR_MERCHANT_ID",
"serviceCode": "ERIP_SERVICE_CODE",
"invoiceNumber": "ORD-12345",
"amount": 125.50,
"currency": "BYN",
"description": "Оплата заказа №12345",
"expireAt": "YYYY-MM-DDTHH:MM:SS",
"callbackUrl": "https://yourshop.by/bitrix/tools/sale_ps_result.php",
"returnUrl": "https://yourshop.by/personal/order/detail/12345/"
}handler.php — логика выставления счёта и проверки статуса .description.php — метаданные, название, иконка .settings.php — bankApiUrl, merchantId, apiKey, serviceCode template/ — отображение реквизитов покупателю — קוד שירות בעץ ERIP, המוקצה על ידי הבנק בעת החיבור. הוא משמש את הקונה למציאת החנות בתפריט ERIP ("חנויות מקוונות → קטגוריה → החנות שלך").
כיצד להציג את פרטי התשלום לקונה?
לאחר הנפקת החשבונית, הציגו:
- מספר חשבונית ERIP (או קוד QR) לתשלום ידני.
- הוראות: "בנקאות אינטרנט → ERIP → חיפוש לפי מספר" או הנתיב דרך עץ השירות.
- תקופת תוקף החשבונית (בדרך כלל 24–72 שעות).
- קוד QR לתשלום מהיר דרך בנקאות מובייל.
ה-{ "merchantId": "YOUR_MERCHANT_ID", "serviceCode": "ERIP_SERVICE_CODE", "invoiceNumber": "ORD-12345", "amount": 125.50, "currency": "BYN", "description": "Оплата заказа №12345", "expireAt": "YYYY-MM-DDTHH:MM:SS", "callbackUrl": "https://yourshop.by/bitrix/tools/sale_ps_result.php", "returnUrl": "https://yourshop.by/personal/order/detail/12345/" } של רכיב מערכת התשלומים מטפל במסך זה. דף "תודה על ההזמנה" הסטנדרטי אינו מתאים כאן — יש צורך בדף המתנה לתשלום עם עדכוני סטטוס דינמיים באמצעות AJAX או WebSocket.
כיצד לעבד הודעות ולאשר תשלום?
הבנק שולח הודעת POST אל serviceCode כאשר מתקבל תשלום. המטפל צריך:
- לוודא את חתימת הבקשה (HMAC, RSA, או רשימת IP מותרת בהתאם לבנק).
- לאתר את התשלום לפי
template/אוcallbackUrl. - לבדוק את הסכום — הקונה עשוי לשלם חלקית.
- לקרוא ל-
invoiceNumberרק עבור תשלום מלא. - לעדכן את סטטוס ההזמנה בהתאם להיגיון העסקי.
תשלום חלקי — מאפיין ייחודי של ERIP. המערכת מאפשרת תשלומים חלקיים. אם זה לא רצוי, ציינו billId בעת רישום החשבונית.
מהניסיון שלנו: חנות לחומרי בניין בלארוסית נתקלה במקרה שבו קונה שילם חשבונית ERIP, אך ההזמנה לא אושרה עקב פער של 1 BYN מהזנה ידנית. הפתרון — הוספת התראה אוטומטית למנהל על חריגות עד 1% וממשק אישור ידני בלוח הניהול. בפרויקט שלכם, נצפה תרחישים דומים.
מה כלול בעבודה
- ניתוח הבנק הסוכן הנבחר וקבלת תיעוד API.
- פיתוח מטפל מותאם אישית תוך התחשבות בפרטי הפרוטוקול של הבנק.
- הגדרת תבנית פרטי התשלום ודף ההמתנה.
- אינטגרציה של הודעות webhook וטיפול בתשלומים חלקיים.
- רישום השירות בעץ ERIP (תמיכה מצד הבנק).
- בדיקת מחזור מלא: הנפקת חשבונית → תשלום → אישור.
- מתן תיעוד התקנה ותפעול.
לוח זמנים ושלבים
| שלב | משך |
|---|---|
| קבלת גישת API מהבנק | 3–10 ימי עסקים |
| פיתוח המטפל | 2–4 ימים |
| אינטגרציה ובדיקות | 1–2 ימים |
| רישום השירות בעץ ERIP | 5–15 ימי עסקים (בנק + NCFO) |
רישום בעץ ERIP הוא השלב הארוך ביותר, שאינו תלוי במפתח. התחילו אותו במקביל לפיתוח.
צרו קשר כדי לחבר ERIP לחנות המקוונת שלכם ב-1C-Bitrix — נעריך את הפרויקט שלכם תוך יום אחד ונציע את הפתרון האופטימלי עבור הבנק שלכם.
אנו מסתמכים על התיעוד הרשמי של ERIP ועל ניסיון רב שנים עם מערכות תשלום של Bitrix.