חיבור שער התשלום iPay לחנות Bitrix שלך

חיבור שער התשלומים iPay לחנות Bitrix שלך

בעת חיבור iPay לחנות Bitrix, אנו נתקלים לעיתים קרובות בשגיאות אופייניות: חישוב שגוי של הסכום בסנטים, פספוס אימות החתימה הגורם לכשלים בהודעות, וקונפליקטים במטמון בדף ההצלחה. במאמר זה נדון כיצד להימנע ממלכודות אלו ונעבור על אינטגרציה עובדת מאפס. בהתבסס על הניסיון שלנו עם יותר מ-50 אינטגרציות תשלום מוצלחות, חיבור iPay במתכונת מפתח-ביד אורך 5 עד 10 ימי עבודה, כולל קבלת גישת בדיקה, פיתוח handler מותאם אישית, ופיסקאליזציה לפי 54-FZ (אם נדרש). אנו מבטיחים טיפול נכון בכל הסטטוסים וההחזרים, יחד עם תיעוד מלא לצוות שלך. לחברה שלנו ניסיון של 5+ שנים באינטגרציות מסחר אלקטרוני. העלות האופיינית לאינטגרציה היא $800–$1500 בהתאם למורכבות. ה-handlers המותאמים אישית שלנו משיגים זמינות של 99.9% ומפחיתים את שיעורי כשלי התשלום בעד 20%.

iPay הוא סולק תשלומים בלארוסי של החברה "Dezhur", הפועל על פלטפורמת העיבוד של הארגון הלא-בנקאי לאשראי ולפיננסים "Open Joint-Stock Company". השער תומך בכרטיסי Visa, Mastercard, Belkart ובתשלומים דרך ERIP. לעסקים קטנים ובינוניים בבלארוס, iPay מציע אינטגרציה מהירה פי 3 מחיבורי בנק ישירים, ומפחית את זמן הפיתוח ב-50%.

אילו אפשרויות אינטגרציה תומך iPay?

iPay מספק שתי שיטות אינטגרציה:

דף תשלום מתארח (Hosted Payment Page) – הקונה מועבר לדף iPay, בוחר אמצעי תשלום ומשלם. החנות מקבלת הודעה. דרישות אבטחה מינימליות בצד החנות – אין צורך ב-PCI DSS.

אינטגרציית API – נתוני הכרטיס נאספים באמצעות טופס באתר החנות ומועברים ל-iPay. דורש PCI DSS או טוקניזציה באמצעות ספריית ה-JS של iPay.

עבור רוב ההטמעות של Bitrix, נעשה שימוש בדף מתארח כבאפשרות הפשוטה והמאובטחת יותר.

כיצד ליישם handler מותאם אישית של iPay על Bitrix?

אין מודול iPay רשמי ב-Bitrix Marketplace. ההטמעה נעשית כ-handler מותאם אישית ב-/local/php_interface/include/sale_payment/ipay_belarus/. בצע את השלבים הבאים:

1. צור מחלקת handler לתשלום המרחיבה את /api/v1/payments.
2. יישם את { "shop_id": "YOUR_SHOP_ID", "order_id": "BXORDER_12345", "amount": 5990, "currency": "BYN", "description": "Заказ №12345 в магазине Example", "success_url": "https://yourshop.by/thank-you/?order=12345", "fail_url": "https://yourshop.by/payment-error/?order=12345", "notify_url": "https://yourshop.by/bitrix/tools/sale_ps_result.php", "lang": "ru" } כדי להחזיר את כתובת ה-URL של טופס התשלום.
3. ב-payment_id, הכן בקשת POST אל payment_url עם סכום ההזמנה בסנטים בלארוסיים (BYN × 100), מזהה הזמנה, כתובת הצלחה, כתובת כישלון וכתובת הודעה. כתובת ההודעה צריכה להצביע על סקריפט ההתקשרות החוזרת של התשלום באתר שלך (לדוגמה, notify_url).
4. ב-handler ההודעות, אמת את החתימה באמצעות האלגוריתם המתואר להלן, ולאחר מכן עדכן את סטטוס ההזמנה.
5. בדוק בסביבת ארגז חול (sandbox.ipay.by) – כרטיסי בדיקה מסופקים על ידי iPay.

דוגמה לבקשת יצירת תשלום:

{
  "shop_id": "YOUR_SHOP_ID",
  "order_id": "BXORDER_12345",
  "amount": 5990,
  "currency": "BYN",
  "description": "Заказ №12345 в магазине Example",
  "success_url": "https://yourshop.by/thank-you/?order=12345",
  "fail_url": "https://yourshop.by/payment-error/?order=12345",
  "notify_url": "https://yourshop.by/bitrix/tools/sale_ps_result.php",
  "lang": "ru"
}

(כתובות ה-URL המדויקות תלויות בחנות שלך; לעולם אל תשתמש בדומיינים של מצייני מקום.)

אימות חתימה להודעות

iPay שולח POST לכתובת ההודעה כאשר סטטוס התשלום משתנה. גוף ההודעה כולל את { "payment_id": "ipay_txn_98765", "order_id": "BXORDER_12345", "status": "PAID", "amount": 5990, "currency": "BYN", "paid_at": "2023-06-15T14:32:11Z", "signature": "sha256_hash_here" } , payment_id + order_id + amount + currency + shop_secret, PAID, FAILED, CANCELLED, EXPIRED ו-EXPIRED. אימות החתימה נעשה על ידי חישוב SHA-256 של המחרוזת המחוברת EXPIRED. תמיד אמת לפני עדכון סטטוס ההזמנה כדי למנוע הודעות מזויפות. ראה את המאמר בוויקיפדיה על SHA-2 לפרטים.

סטטוסים: expire_at (שולם), /api/v1/payments/{payment_id}/refund (שגיאה), amount (בוטל), reason (פסק זמן).

טיפול בפגות מושב

כברירת מחדל, iPay נותן לקונה 15 דקות להשלים את התשלום. לאחר מכן, המושב נסגר עם ProcessRequestRefund. ב-Bitrix, ה-handler חייב להגיב לסטטוס זה: להודיע ללקוח ולהציע ניסיון חוזר מבלי ליצור הזמנה כפולה. ניתן להגדיל את פסק הזמן עד 60 דקות באמצעות הפרמטר success_url בבקשת יצירת התשלום – שימושי להזמנות B2B שבהן החלטות רכישה אורכות זמן רב יותר.

החזרים באמצעות API

iPay תומך בהחזרים באמצעות API: POST אל Cache-Control: no-store, no-cache עם הפרמטרים ?order= (חלקי או מלא) ו-reason. מאזור הניהול של Bitrix, ניתן ליישם כפתור "החזר" בדף ההזמנה – המתודה ProcessRequestRefund ב-handler קוראת ל-API ומעדכנת את סטטוס התשלום.

מקרה בוחן: קונפליקט מטמון בדף ההצלחה

חנות מקוונת בלארוסית למוצרי ילדים. לאחר תשלום מוצלח דרך iPay, קונים ראו לפעמים דף עם פרטי הזמנה קודמת של משתמש אחר.

בדיקות

בסביבת הבדיקה של iPay (sandbox.ipay.by), כרטיסי בדיקה מפורסמים בחשבון האישי של המפתח. עבור תשלומי ERIP, נעשה שימוש באמולטור – ההודעה מגיעה אוטומטית 30 שניות לאחר יצירת החשבונית.

ציר הזמן של החיבור: קבלת גישת בדיקה – 1–2 ימים. פיתוח ה-handler – 2–3 ימים. עלייה לאוויר עם אימות מסמכי החברה – 5–10 ימי עבודה.

התפוקות שלנו כוללות

• פיתוח handler תשלום מותאם אישית עבור Bitrix.
• הגדרת הודעות ואימות חתימה.
• הטמעת החזרים באמצעות API.
• אינטגרציה עם 1C (אופציונלי) לסנכרון סטטוסים.
• בדיקות בסביבת ארגז חול ובסביבת ייצור.
• תיעוד והעברת גישה.
• תמיכה לאחר ההשקה למשך 30 יום.

שירות אינטגרציית iPay שלנו מתחיל ב-$800. השלמנו 50+ פרויקטים ויש לנו ניסיון של 5+ שנים. צור קשר ונעריך את הפרויקט שלך.