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

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

תארו לעצמכם: חנות מקוונת חיברה את EasyPay, אבל לקוחות מתלוננים שההזמנות לא מאושרות לאחר תשלום במסוף. העיכוב בהודעות מרשת המסופים של EasyPay מגיע לכמה שעות. ללא מנגנונים נוספים, הלקוח רואה את הסטטוס "ממתין לתשלום" ונהיה חרד. האינטגרציה שלנו פותרת זאת: בדיקת סטטוס כל 30 שניות מקצרת את זמן האישור ל-30 שניות — פי 20 מהר יותר מהגישה הסטנדרטית.

EasyPay הוא שירות תשלומים בלארוסי עם רשת מסופים וסליקה אינטרנטית. הקונה יכול לשלם עבור הזמנה באינטרנט בכרטיס או לקבל קוד ייחודי לתשלום במזומן במסוף. בבלארוס, האפשרות השנייה פופולרית במיוחד: כ-30% מהאוכלוסייה אינם משתמשים בכרטיסי בנק. עבור חנות Bitrix, זו מערכת תשלום נפרדת במודול sale עם לוגיקת תשלום דחוי.

אילו בעיות פותרת אינטגרציית EasyPay?

עיכוב בהודעות. תשלומי מסוף מ-EasyPay מגיעים בעיכוב של 5 דקות עד שעתיים. ללא עיבוד, הקונה לא רואה אישור תשלום. פתרון — בדיקת JS כל 30 שניות דרך נקודת קצה AJAX מותאמת אישית שקוראת ל-API של EasyPay GET /api/v1/invoice/{invoiceId}. בפרויקט אחד (חנות אלקטרוניקה במינסק), זה קיצר את זמן האישור מ-40 דקות ל-30 שניות — והפחית את עומס התמיכה ב-70%.

חשבוניות שפג תוקפן. EasyPay שולחת הודעת status: EXPIRED כאשר המועד חולף. ב-Bitrix, יש לטפל בסטטוס זה: לבטל אוטומטית הזמנות שלא שולמו או להשאיר אותן להחלטה ידנית. עבור חנויות עם מאות הזמנות ביום, הגדרנו סקריפט cron שבודק את כל ההזמנות בסטטוס "ממתין לתשלום" פעם בשעה וקורא ל-API לעדכון. זה מצמצם הזמנות תקועות לאפס.

תצוגה שגויה של קוד המסוף. תבנית Bitrix הסטנדרטית מציגה רק "ממתין לתשלום" ללא הוראות. בתבנית מותאמת כראוי — קוד תשלום גדול, הוראות ומפת המסופים הקרובים דרך API של EasyPay. זה מפחית פניות לתמיכה ב-70%.

למה חשובה בדיקת סטטוס?

ללא בדיקה, סטטוס ההזמנה מתעדכן רק עם קבלת הודעה מ-EasyPay. בתשלום במסוף, ההודעה יכולה לקחת עד שעתיים. הקונה עוזב את האתר ללא אישור. בדיקה פותרת זאת: JS בדף ההזמנה בודק סטטוס כל 30 שניות דרך נקודת הקצה AJAX שלכם. ברגע שהתשלום מאושר — ההזמנה עוברת מיידית לסטטוס "הושלם". זה קריטי עבור חנויות מקוונות עם מוצרים שנמסרים תוך שעות.

איך אנו מיישמים את האינטגרציה?

ערימת טכנולוגיות: 1C-Bitrix CMS (infoblocks v2.0, ORM), PHP 8.1+, MySQL/MariaDB, מטמון מתויג. אנו משתמשים ב-API הרשמי של EasyPay: https://checkout.easypay.by/api/ (ייצור) ו-https://sandbox.easypay.by/api/ (sandbox).

ההנדלר ממוקם ב-/local/php_interface/include/sale_payment/easypay_belarus/. אתחול תשלום — POST אל /api/v1/invoice עם פרמטרים:

{
  "serviceId": "YOUR_SERVICE_ID",
  "accountNo": "BXORDER_45678",
  "amount": {
    "value": 7850,
    "currency": "BYN"
  },
  "info": "Заказ №45678",
  "returnUrl": "https://shop.by/personal/order/detail/45678/",
  "notifyUrl": "https://shop.by/bitrix/tools/sale_ps_result.php",
  "expiredAt": "2024-12-20T18:00:00+03:00"
}

סכום בקופיקות BYN. { "serviceId": "YOUR_SERVICE_ID", "accountNo": "BXORDER_45678", "amount": { "value": 7850, "currency": "BYN" }, "info": "Заказ №45678", "returnUrl": "https://shop.by/personal/order/detail/45678/", "notifyUrl": "https://shop.by/bitrix/tools/sale_ps_result.php", "expiredAt": "2024-12-20T18:00:00+03:00" } מונפק בעת החיבור. התשובה מכילה serviceId ואת invoiceId (כרטיס מקוון) או paymentUrl (קוד מסוף). בהתאם למצב, ההנדלר מפנה לכתובת URL או מציג את הקוד עם הוראות.

עיבוד הודעות: EasyPay שולחת POST אל paymentCode בעת תשלום מוצלח:

{
  "invoiceId": "ep_inv_112233",
  "accountNo": "BXORDER_45678",
  "status": "PAID",
  "amount": 7850,
  "currency": "BYN",
  "paidAt": "2024-12-19T15:22:41+03:00",
  "paymentMethod": "TERMINAL",
  "sign": "hmac_sha256_value"
}

notifyUrl יכול להיות { "invoiceId": "ep_inv_112233", "accountNo": "BXORDER_45678", "status": "PAID", "amount": 7850, "currency": "BYN", "paidAt": "2024-12-19T15:22:41+03:00", "paymentMethod": "TERMINAL", "sign": "hmac_sha256_value" } , paymentMethod, CARD. אימות חתימה — HMAC-SHA256 של המחרוזת TERMINAL. פרטים נוספים בתיעוד: HMAC.

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

• ניתוח ועיצוב ארכיטקטורה לקטלוג שלכם
• פיתוח הנדלר התומך בכרטיסים, מסופים ו-ERIP
• התאמת תבנית להצגת קוד תשלום עם הוראות
• הטמעת בדיקת סטטוס JS כל 30 שניות
• טיפול בחשבוניות שפג תוקפן וביטול הזמנות
• בדיקות ב-sandbox של EasyPay (כרטיס, מסוף, פקיעת תוקף)
• הכנת תיעוד והוראות לצוות
• תמיכה לאחר השקה — שבועיים

השוואת מצבי תשלום של EasyPay

טעויות נפוצות באינטגרציה עצמית

• פורמט סכום שגוי (קופיקות, לא דולרים) — EasyPay דוחה את הבקשה.
• חוסר טיפול בסטטוס EXPIRED — הזמנות תקועות בהמתנה.
• אימות חתימה חלש — סיכון לקבלת הודעות מזויפות.
• התעלמות מ-timeouts — עם עיכוב ברשת המסופים, הקונה לא רואה עדכון.

למה להפקיד בידינו את האינטגרציה?

יש לנו למעלה מ-50 אינטגרציות של מערכות תשלום עם 1C-Bitrix בחמש השנים האחרונות. אנו מכירים את כל המלכודות: מתכונות לא מובנות מאליהן ב-API של EasyPay ועד להגדרת מטמון מתויג נכון. אנו מבטיחים שההנדלר יעבור את המודרציה של EasyPay בניסיון הראשון. אתם חוסכים עד 30% מעלויות הפיתוח בהשוואה לביצוע עצמי — אתם מקבלים פתרון מוכן ללא סיכון לשגיאות. צרו קשר — נבחן את הפרויקט שלכם תוך יום אחד. קבלו ייעוץ על שילוב EasyPay עם חנות ה-Bitrix שלכם.

לוחות זמנים

סה"כ: משבוע עד 3 שבועות במפתח מלא. העלות מחושבת באופן אישי — כתבו לנו ונשוחח.