אינטגרציה של 1C-Bitrix עם מערכת התשלומים Assist Belarus

אינטגרציה של Assist Belarus עם Bitrix: היכן התשלום נשבר

האינטגרציה של Assist Belarus עם Bitrix נשברת לא בשלב החיבור, אלא בשלב התפעול: החנות מקבלת תשלום, אך ההזמנה נשארת בסטטוס "ממתין", המוצר אינו נשמר במלאי, והלקוח מתקשר עם קבלה ביד. הסיבה כמעט תמיד אחת — חוסר סנכרון בין תגובת שער התשלומים לבין המטפל שמשנה את סטטוס ההזמנה במערכת.

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

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

השלישי — חוסר סנכרון בין המלאי לתשלום. שמירת המלאי מבוטלת לפי timeout לפני שמגיע אישור מהשער, והפריט עובר לקונה אחר. בתוצאה — הזמנה מבוטלת עם תשלום ובירור עם הלקוח.

כל שלושת הכשלים מטופלים לא ב"שיפור הכפתור", אלא בעיבוד אידמפוטנטי של התראות, ביומן פעולות ובהשוואת סטטוסי הזמנות תשלום לפי לוח זמנים. מפרקים כיצד זה נסגר בצד החנות.

מה נותן מעגל תשלומים שנבנה כראוי

מעגל תשלומים הוא לא "כפתור תשלום באתר", אלא שרשרת: סל → הזמנה ב-Битрикс → בקשה אל Assist Belarus → אישור → סטטוס הזמנה ומסמכי מלאי. קרע בכל חוליה יוצר סוג של כשלים "שילם, אבל ההזמנה לא נוצרה": הלקוח רואה חיוב, ובמערכת — סל נטוש.

שיעור התשלומים המוצלחים במעגל כזה יורד ב-15-30% לא בגלל שער התשלומים, אלא בגלל אי-סנכרון סטטוסים וזמני המתנה בחזרה מדף התשלום.

החלק המרכזי — אישור הזמנה אוטומטי. מטפל ההתראות של Assist מקבל callback, בודק חתימה, משווה סכום ומספר הזמנה, ורק לאחר מכן מעביר את ההזמנה ל"שולם". אידמפוטנטיות הכרחית: callback חוזר ממערכת התשלומים לא צריך ליצור הזמנה שנייה או לשכפל חיוב.

אם הלקוח סגר את הדפדפן לפני החזרה — ההזמנה בכל זאת מאושרת לפי התראה בשרת, ולא לפי פתיחת דף ה"תודה".

התאמת תשלומים סוגרת פערים בין מרשם Assist לסטטוסים ב-Битрикс. החלפה לילית משווה פעולות שבוצעו עם הזמנות ומסמנת את אלו שבהן התשלום עבר אך הסטטוס לא עודכן — ניתן לראותן ולטפל בהן, ולא לחפש ידנית בדף חשבון. היקף ההתאמות הידניות יורד מבדיקה יומית של כל הפעולות לבדיקת פערים בודדים.

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

זהו האפקט המדיד: שיעור גבוה יותר של תשלומים מוצלחים, אישור הזמנה תוך שניות ולא לאחר בדיקה ידנית, והתאמה צפויה מראש במקום ניתוח דפי חשבון.

דרכי חיבור: השוואת אפשרויות

קיימות שלוש גישות לקבלת תשלומים דרך Assist Belarus, והבחירה ביניהן נעשית לא לפי "יופי" הקוד, אלא לפי מידת אי-הסטנדרטיות של החילוף שלכם עם מערכת התשלומים ומי יתחזק את האינטגרציה לאחר העלייה לאוויר.

למה לשים לב בעת הבחירה

השאלה המרכזית היא היכן חיה לוגיקת סטטוסי ההזמנה. אם היא מפוזרת בין מודול התשלום ל-1С, כל אי-התאמה בחילוף מובילה להזמנה ששולמה אך לא נרשמה, ונדרש לטפל בכך ידנית. שירות המתווך מסיר את התלות ההדדית הזו: האתר ומערכת החשבונאות מתקשרים עם צומת אחד, ולא ישירות זה עם זה.

מה נותן שירות המתווך

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

אם יש לכם אתר אחד והזמנות סטנדרטיות — מודול תקני מספיק, ולא נסבך unnecessarily. ברגע שמופיעים תשלומים חלקיים, מספר נקודות או חיבור ל-1С — שוקלים את האפשרות עם המתווך. תארו כיצד בנויה ההזמנה והחשבונאות אצלכם — נחזור עם הערכה ותוכנית לפי הסכימה הנבחרת.

איך מתבצעת ההטמעה: שלבי העבודה

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

כבר בשלב הזה רואים איפה התשלום יאבד: תבנית מותאמת אישית של הרכיב, מטפל סטטוסים שנכתב באופן עצמאי או חילוף עם 1C שדורס הזמנה ששולמה.

1. בדיקת החנות והחילוף. מתעדים את סכמת סטטוסי ההזמנה, נקודות הקריאה של תרחיש התשלום ואיך הנתונים עוברים ל-1C. בודקים אם שיטת התשלום החדשה מתנגשת עם אלו שכבר פועלות.
2. תכנון סכמת התשלום. קובעים אילו תרחישים נדרשים: תשלום מלא, חלקי, החזר, ניסיון חוזר לאחר סירוב. מתאמים באיזה שלב ההזמנה נחשבת למשולמת ואיזה סטטוס היא מקבלת במערכת החשבונאית.
3. הגדרת החילוף. מחברים את שער התשלומים, מגדירים את חתימת הבקשות ואת עיבוד ההתראות ממערכת התשלומים. בנפרד סוגרים את נושא האידמפוטנטיות: התראה חוזרת לא צריכה ליצור תשלום שני או לשכפל את ההזמנה.
4. תשלומי בדיקה. מריצים את כל המחזור במתאר בדיקה: תשלום מוצלח, סירוב, ביטול על ידי המשתמש, החזר. מוודאים שהסטטוסים בחנות וב-1C תואמים לאחר כל תרחיש.
5. בדיקה על תעבורה אמיתית. מפעילים את התשלום עבור חלק מוגבל של הזמנות, בודקים את יומני החילוף ואת התאמת הסכומים. זה תופס אי-התאמות שמתאר הבדיקה לא משחזר.
6. העברה לתמיכה. מוסרים את נהלי הליווי: איך לקרוא את יומן התשלומים, מה לעשות במקרה של אי-התאמה בסטטוס, איך להחזיר שינויים לאחור.

לאחר ההעברה, צוות הליווי יודע היכן לחפש את הסיבה אם התשלום לא הגיע או הסטטוס לא התעדכן. תארו את המשימה שלכם — נחזור עם הערכה ותוכנית עבודה.

מה הלקוח מקבל לידיו לאחר סיום העבודה

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

• קונפיגורציית התממשקות בין האתר לשער התשלומים: פרמטרי חיבור, רשימת כתובות IP מורשות, הגדרות חתימת בקשות וזמני פסק זמן. בנפרד מתעדים אילו ערכים משתנים בעת מעבר לדומיין או לשרת אחר.
• סכמת סטטוסים של הזמנה — טבלת התאמה: סטטוס בצד מערכת התשלומים → סטטוס ב-Bitrix → פעולת המערכת (ליצור תשלום, לשלוח מייל, לאשר משלוח). לפיה ניתן לראות מדוע הזמנה לא עברה ל"שולם", בלי לקרוא קוד.
• נוהל החזרים: מי יוזם, אילו בדיקות מתבצעות לפני שליחת הבקשה, כיצד מתעדים את התוצאה ומה קורה במקרה של סירוב מערכת התשלומים. עם זמני תגובה מוגדרים בכל שלב.
• מדריך למנהל — שלב אחר שלב, עם צילומי מסך אמיתיים: כיצד לבדוק תשלום, מה לעשות במקרה של תשלום תקוע, לאן להסתכל במקרה של אי-התאמה בסכום. מיועד לעובד ללא ידע טכני.
• מדיניות גישה: תפקידים והרשאות להגדרות תשלום, תיעוד פעולות ביומן, נוהל רוטציית מפתחות. מפתחות אינם נשמרים בצורה גלויה במאגר הקוד.
• תיעוד האינטגרציה: מפת זרימות ההזמנה מהסל ועד לאישור, נקודות לוגינג, רשימת תלויות חיצוניות ואנשי קשר להסלמה.
• צ'ק-ליסט קבלה עם תרחישי בדיקה: תשלום מוצלח, סירוב, ניסיון חוזר, החזר — כדי שתוכלו לבדוק את העבודה בעצמכם, בלי לחכות לנו.

כל זה מועבר למערכת בקרת הגרסאות והוויקי שלכם, ולא נשאר בהתכתבות. תארו את המשימה — נחזור עם הערכה ותוכנית, כולל הרכב הארטיפקטים בהתאם לתהליך שלכם.

מקרה בוחן: חנות עם התאמת תשלומים ידנית

חנות אלקטרוניקה על 1С-Битрикс קיבלה תשלומים דרך Assist Belarus, אך אישור ההזמנה התנהל במצב חצי-ידני: המנהל היה מייצא אחת לשעה קובץ תנועות מחשבון הניהול של שער התשלומים, מתאים אותו להזמנות בממשק הניהול ומעביר סטטוסים ידנית.

בזרימה של 300-400 הזמנות ביום, ההתאמה גזלה 2-3 שעות מזמן העבודה, ובימים עמוסים — עד חמש. הזמנות ששולמו בערב או בסופי שבוע נתקעו בסטטוס "ממתין לתשלום" עד הבוקר למחרת, וחלק מהלקוחות הספיקו לבצע הזמנה חוזרת או לעבור למתחרים.

שורש הבעיה לא היה בשער עצמו, אלא בכך שהתראותיו על תוצאת התשלום לא הגיעו ללוגיקת ההזמנה: המטפל השיב לבקשה, אך לא שינה סטטוס, לא רשם תנועה ולא הפעיל הודעת דואר.

אנו בנינו מחדש את קליטת התשלומים: חיברנו מטפל התראות עם בדיקת חתימה וסכום, קישרנו אותו לסטטוסי ההזמנה ב-Битрикс, הוספנו אידמפוטנטיות — התראה חוזרת על אותה תנועה לא יוצרת כפילות ולא מאפסת הזמנה שכבר אושרה.

בנפרד יצרנו התאמת-שומר: אחת ליום המערכת עצמה משווה את קובץ תנועות השער להזמנות ומסמנת אי-התאמות, כך שהנהלת החשבונות רואה רק חריגים אמיתיים.

חודש לאחר ההשקה שיעור התשלומים המוצלחים עלה מ-71% ל-89% — בעיקר הודות לכך שהלקוח ראה אישור מיד ולא נטש את הסל. זמן האישור הצטמצם ל-1-2 דקות, ההתאמה הידנית הפכה לטיפול באי-התאמות בודדות, והמנהלים עברו מייצוא נתונים לעבודה עם לקוחות.

אותו קו מתאר אנו חוזרים עבור חנויות אחרות על Битрикс: לוגיקת קליטת התשלומים מועברת, משתנים רק פרטי החשבון וכללי הסטטוסים.

במה שונה תשלום בכרטיס מתשלום דרך בנק מקוון?

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

בבנק מקוון הקונה עובר לאפליקציית הבנק, מאשר את הפעולה שם, והתשובה עשויה לחזור באיחור — לעיתים תוך דקות, ולעיתים לאחר שהלקוח סגר את הלשונית.

אם האינטגרציה Assist Belarus עם Битрикс בנויה רק על הפניה "יצא-חזר", תשלומים כאלה הולכים לאיבוד: הכסף נחייב, וההזמנה נשארת ללא תשלום.

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

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

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

אנחנו מפרידים בין הזרמים האלה ברמת הלוגיקה: מטפלים שונים בהתראות, סטטוסים שונים להזמנה, יומן תשלומים נפרד עם ניסיונות ותשובות מהשער. זה נותן התאמה צפויה מול הבנק ומסיר סוג של שגיאות שבהן יש תשלום, אבל ההזמנה לא נסגרת.

ספקות טכניים נפוצים לפני ההתחלה

לפני ההתחלה כמעט תמיד עולות אותן שאלות בדיוק — הן לא עוסקות בבחירת שער תשלומים, אלא באופן הטמעתו בחנות שכבר פועלת, בלי השבתה ובלי אובדן הזמנות. להלן ניתחנו ארבעה תרחישים שברוב המקרים מעכבים את קבלת ההחלטה.

האם יש סביבת בדיקות ומה בודקים בה?

כן, עובדים במצב בדיקות של מערכת התשלומים: מריצים תשלום מוצלח, סירוב של הבנק, פסק זמן ובקשה חוזרת. בנפרד בודקים שסטטוס ההזמנה ב‑Битрикс משתנה בדיוק פעם אחת — כפילויות של התראות משער התשלומים מנוטרלות לפי מזהה העסקה. רק לאחר מכן מפעילים את סביבת האמת.

איך מגדירים החזרים?

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

יש לנו כמה ישויות משפטיות — אפשר להפריד את הזרימות?

כן. לכל ישות משפטית מתאימים מזהה חנות משלה במערכת התשלומים, וב‑Битрикс מקשרים אותו לאתר או למחסן. ההזמנות והדוחות אינם מתערבבים, והנהלת החשבונות מקבלת ייצוא עבור הישות המשפטית הנדרשת בלי פיצול ידני.

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

נדון במשימה שלך ונחזור עם תוכנית

כדי שההערכה תהיה מדויקת ולא "ממוצע שוק", עלינו להבין את החנות שלך לפני תחילת העבודה. תאר באיזה ענף של 1С-Битрикс פועל הפרויקט, כיצד בנויים הקטלוג והסל, אילו תרחישי תשלום כבר בשימוש ואילו יש להוסיף.

בנפרד חשוב כיצד בנוי כעת החיבור עם 1С: ייצוא פריטים, מלאי ומחירים, ביצוע הזמנות, סטטוסים. מכך תלוי היכן בדיוק יתמקם מודול התשלום והאם יהיה צורך לבנות מחדש את לוגיקת ביצוע ההזמנה.

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

אם החנות כבר מקבלת תשלומים דרך מערכת אחרת, נבחן את ההגדרות הנוכחיות והיסטוריית הפעולות — כך נבין מה להעביר ומה לבנות מחדש מאפס.

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

• הערכת לוחות זמנים לכל שלב: חיבור המודול, הגדרת תרחישי תשלום, תשלומי בדיקה, העלאה לפרודקשן.
• תוכנית עבודה עם סדר הפעולות ונקודות שבהן נדרשת השתתפותך או הרשאות גישה.
• ניתוח תרחישי תשלום עבור החנות שלך: תשלום מלא, תשלום מקדים, תשלום בעת קבלה, החזרים.
• תרשים האינטראקציה של מודול התשלום עם ביצוע ההזמנה והחיבור עם 1С.
• רשימת הרשאות ונתונים שיידרשו להתחלה: חשבונות בדיקה ועבודה, מפתחות, פרטי חשבון.
• אפשרויות חזרה לאחור וסדר הפעולות אם תשלום לא עובר או נתקע בצד הבנק.
• בסעיף נפרד — מה עושים עם הזמנות שכבר בוצעו אך לא שולמו ברגע המעבר.

תאר את החנות הנוכחית ותרחישי התשלום — נחזור עם הערכת לוחות זמנים ותוכנית עבודה שאפשר להתחיל לפיה ללא השלמות תוך כדי תנועה.