יעד שריג ופלאקארד עובדים אצל אלפי עסקים אבל כמעט לא נדונים. איך נראה כל ממשק בפועל, איפה התיעוד יושב היום, ומה לברר לפני שמתחייבים ללוח זמנים.
עיקרי הדברים
- אלה לא ספקים חדשים. הם מופיעים בפרויקטים כי העסק כבר עובד איתם שנים, ולא כי מישהו בחר בהם עכשיו.
- יעד שריג חברה ב-2021 לקבוצת Hyp יחד עם כספית, איזיקאונט וקרדיט גארד, וזה מסביר למה חלק מהקישורים הישנים מובילים היום לאתר Hyp.
- עמוד המפתחים ההיסטורי של יעד מפנה כיום לעמוד התשלומים המקוונים של Hyp, ותיעוד ה-API מתארח ב-Apiary תחת השם Hyp Pay.
- פלאקארד מפרסמת בעמוד המפתחים שלה ארבעה שערים, ובהם גרסאות SANDBOX ייעודיות ל-Gateway API ול-IFrame/Redirect.
- לצד השער החדש עדיין קיים אצל פלאקארד שירות SOAP ותיק, ולכן קוד קיים בפרויקט אינו ראיה לדור שאתם אמורים לפתח מולו.
יעד שריג ופלאקארד הם שני שערי סליקה ותיקים עם בסיס מותקן גדול בישראל ונוכחות קטנה בשיח הפיתוח. יעד שריג פועלת כיום כחלק מקבוצת Hyp, ופלאקארד מפרסמת מספר דורות ממשק במקביל. בשני המקרים העבודה הראשונה היא לזהות באיזה דור אתם.
למה אלה עולים בפרויקטים בכלל
לא בגלל השוואת ספקים. הם עולים כי העסק כבר סולק דרכם, יש חוזה, יש מסלולי עסקה מוגדרים, ולעיתים גם מסופים פיזיים מאותה משפחה. החלפת שער סליקה היא מהלך מסחרי עם עלות אמיתית, ולכן ההנחה הנכונה בתחילת פרויקט היא שאתם מתחברים למה שיש, לא בוחרים מחדש.
זה משנה את סדר העבודה. במקום להשוות יכולות, אתם מבררים שלושה דברים: איזה דור ממשק פעיל אצל העסק, מי מחזיק את פרטי הגישה, ומה כבר מוטמע היום באתר או במערכת.
איך נראית אינטגרציה ליעד שריג בפועל?
הדפוס המרכזי הוא עמוד תשלום מתארח שאליו מפנים את הלקוח עם פרמטרים במחרוזת שאילתה. אפשר לראות את זה בכל קישור תשלום חי של השירות: הכתובת יושבת תחת icom.yaad.net, ונושאת פרמטרים כמו Masof למספר המסוף, Amount, Coin למטבע, Tash למספר תשלומים, Info לתיאור, Order למזהה ההזמנה, UTF8out לקידוד התשובה, ו-signature לחתימה. שלוש צורות החיבור - דף סליקה, iframe ו-API ישיר - נבדלות בעיקר בהיקף ה-PCI: דף סליקה מול iframe מול API.
שתי נקודות שחשוב לדעת לפני שמתחילים:
- המותג התפצל מהכתובת. עמוד המפתחים ההיסטורי תחת
yaadpay.yaad.net/developers/מפנה כיום לעמוד התשלומים המקוונים באתר Hyp. אוסף התיעוד ב-Apiary תחתyaadpay.docs.apiary.ioנושא היום את הכותרת Hyp Pay. אם אתם מחפשים "יעד" ומגיעים ל-Hyp, זו לא טעות. - החתימה היא חלק מהממשק. קיים פרמטר
signatureבקריאות, כלומר יש שלב הכנה בצד השרת לפני שמפנים את הלקוח. אל תתכננו הפניה שנבנית כולה בדפדפן.
מה שלא ניתן לאמת מהתיעוד הציבורי כרגע: קיומו של מסוף בדיקה מתועד, אופן חישוב החתימה במדויק, ותמיכה מתועדת בטוקנים או בחיוב חוזר. את אלה מבררים מול הספק בכתב לפני שמתחייבים לתאריך.
איך נראית אינטגרציה לפלאקארד בפועל?
בעמוד המפתחים של פלאקארד תחת gateway20.pelecard.biz מופיעים ארבעה שערים בשמותיהם: Payment - Gateway 2.0 API, Payment - IFrame/Redirect, ולצידם Payment - Gateway API SANDBOX ו-Payment - IFrame/Redirect SANDBOX. כלומר לשני מודלי ההטמעה יש גרסת בדיקה נפרדת ומוצהרת, וזה יתרון אמיתי בפרויקט תשלומים.
לצד זה קיים דור ותיק יותר: שירות SOAP תחת ws101.pelecard.biz/WebServices.asmx, עם פעולות בשמות כמו DebitRegularType. הוא עדיין מופיע בספריות ובתוספים של צד שלישי. בנוסף מתפרסמת סביבת עבודה ציבורית ב-Postman בשם Pelecard Public, שכוללת חלק תיעוד בשם gateway21.
המסקנה המעשית: אם ירשתם קוד פלאקארד, הדבר הראשון לבדוק הוא לאיזו כתובת הוא פונה. קוד שפונה ל-WebServices.asmx וקוד שפונה לשער 2.0 אינם שני סגנונות של אותו דבר, אלא שתי אינטגרציות שונות עם מודל שגיאות שונה.
שני הממשקים זה מול זה
| יעד שריג / Hyp | פלאקארד | |
|---|---|---|
| מודל עיקרי גלוי | עמוד תשלום מתארח עם פרמטרים ב-URL | שער API וגם IFrame/Redirect |
| דומיין שמופיע בפועל | icom.yaad.net | gateway20.pelecard.biz, וגם ws101.pelecard.biz הוותיק |
| איפה התיעוד יושב | Apiary בשם Hyp Pay; עמוד המפתחים הישן מפנה ל-Hyp | עמוד מפתחים ייעודי, ובנוסף סביבת Postman ציבורית |
| סביבת בדיקה מוצהרת | לא אותרה בתיעוד ציבורי | כן, שני שערי SANDBOX נפרדים |
| דורות מקבילים | מותג שהשתנה, כתובות ישנות שמפנות מחדש | SOAP ותיק לצד שער חדש |
| מה לברר ראשון | איזה תיעוד תקף היום ומול מי | לאיזה דור מחוברת המערכת הקיימת |
מה עולה זמן כשהתיעוד לא נגיש מראש
- הערכת עבודה שנבנתה על ניחוש. בלי לראות תיעוד אי אפשר לדעת אם יש טוקן, אם יש זיכוי דרך הממשק, ואם יש התראה לשרת.
- ספרייה ישנה מ-GitHub. היא עובדת מול הדור שהיה קיים כשנכתבה, ולא בהכרח מול מה שהעסק מחובר אליו.
- בדיקות בייצור. בלי סביבת בדיקה כל ניסיון הוא עסקה אמיתית, זיכוי אמיתי ורישום חשבונאי אמיתי.
- פרטי גישה אצל מנהל החשבונות. מספר המסוף וסיסמת הממשק לרוב אינם אצל מי שביקש את הפרויקט.
- תשובות במקום שגיאה. ממשקים ותיקים מחזירים לעיתים 200 עם שדה שגיאה בגוף, ולכן בדיקה לפי קוד HTTP בלבד תסמן כישלון כהצלחה.
איך מעריכים ספק שאי אפשר לקרוא את התיעוד שלו מראש?
בשאלות בכתב לפני שנותנים לוח זמנים. אלה השאלות שמשנות את ההערכה:
- מהו הדור הפעיל אצלנו, ומהי כתובת הבסיס שאליה נפנה בייצור?
- האם קיימת סביבת בדיקה, ואיך מקבלים אליה פרטי גישה?
- איך נראית תשובה מוצלחת ואיך נראית תשובה כושלת, עם דוגמה אמיתית של כל אחת?
- האם יש שמירת אמצעי תשלום לחיוב חוזר, ובאיזה מנגנון?
- האם קיים זיכוי דרך הממשק, והאם הוא חלקי או מלא בלבד?
- האם יש התראה שרת-לשרת בסיום עסקה, או שההסתמכות היא על חזרת הדפדפן?
- מי איש הקשר הטכני, ומה זמן התגובה שלו כשמשהו נשבר בייצור?
התשובה לשאלה השישית היא זו שמכריעה איכות. מערכת שמסתמכת רק על חזרת הדפדפן תאבד הזמנות בכל פעם שלקוח סוגר לשונית מוקדם.
מה שומרים בכל מקרה, בלי קשר לספק
- מזהה ההזמנה הפנימי שלכם, שנוצר לפני הפנייה לשער.
- הסכום והמטבע כפי שנשלחו, לצד הסכום שחזר.
- מזהה העסקה אצל הספק, בשדה ייעודי ולא בתוך טקסט חופשי.
- קוד התשובה והתיאור המלא כפי שהתקבלו, גם בהצלחה.
- זמן הבקשה וזמן התשובה, כדי לזהות תקלות זמן קצוב.
- ארבע ספרות אחרונות וסוג הכרטיס בלבד. לעולם לא מספר כרטיס מלא או קוד אבטחה.
זהו תיאור של מה שנגיש בפומבי בספטמבר 2026. שמות שערים, כתובות ומיקומי תיעוד משתנים, ויש לאמת מול הספק לפני מימוש.
קשור: השוואת שערי סליקה בישראל, קודי דחייה ותרגומם לפעולה, אינטגרציה ל-API של Tranzila.
מקורות
שאלות נפוצות
יעד שריג ו-Hyp הם אותה חברה?
יעד שריג פועלת כחלק מקבוצת Hyp, שנוצרה ב-2021 מחיבור בין יעד שריג לכספית, איזיקאונט וקרדיט גארד. מבחינה מעשית זה אומר שקישורים ותיעוד ישנים עשויים להפנות לאתר Hyp, ושאוסף התיעוד ב-Apiary מופיע היום תחת השם Hyp Pay.
לפלאקארד יש סביבת בדיקה?
כן. בעמוד המפתחים שלה מופיעים ארבעה שערים, ובהם Payment - Gateway API SANDBOX ו-Payment - IFrame/Redirect SANDBOX לצד גרסאות הייצור. זה אומר שאפשר לפתח מול סביבה נפרדת במקום להריץ עסקאות אמיתיות, וזה חוסך גם זיכויים מיותרים וגם רישומים חשבונאיים מיותרים.
ירשתי קוד פלאקארד ישן, האם הוא עדיין רלוונטי?
בדקו קודם לאיזו כתובת הוא פונה. קוד שפונה ל-`ws101.pelecard.biz/WebServices.asmx` הוא הדור הוותיק מבוסס SOAP, וקוד שפונה לשער 2.0 הוא דור אחר לגמרי. אלה אינן שתי גרסאות של אותו ממשק, ולכן אי אפשר להעביר טיפול בשגיאות בין השניים.
איפה מוצאים היום את התיעוד של יעד שריג?
העמוד ההיסטורי תחת `yaadpay.yaad.net/developers/` מפנה כיום לעמוד התשלומים המקוונים באתר Hyp, ואוסף התיעוד ב-Apiary נושא את הכותרת Hyp Pay. אם אתם צריכים פרטים שאינם מופיעים שם, כמו מסוף בדיקה או חישוב חתימה, בקשו אותם בכתב מהספק.
להמשך קריאה
שירות רלוונטי
אינטגרציות
לגרום למערכות שאתם כבר משלמים עליהן לדבר זו עם זו.
על הכותב
יהונתן סעדיה
מפתח פרילנסר לאוטומציה, אתרים ו-MVP
אני יהונתן סעדיה, מפתח בכיר שבונה אוטומציה עסקית, אתרים מותאמים ומוצרי MVP לעסקים קטנים ובינוניים בארה"ב, אירופה וישראל. המדריכים האלה נכתבים מתוך עבודה אמיתית עם לקוחות, לא מתיאוריה.
בוא נעבוד יחדיש לך פרויקט דומה?
ספר לי מה אתה רוצה לבנות או איזה תהליך להפוך לאוטומטי. אני חוזר תוך 24 שעות עסקים עם כמה שאלות ממוקדות, ואז עוברים על זה יחד בשיחת היכרות חינמית של 30 דקות, בלי התחייבות. בסוף יש לך היקף עבודה, לוח זמנים ומחיר קבוע - או תשובה כנה שלא שווה לבנות את זה.