חיבור הסליקה שלכם

1. היכנסו למסך הניהול של PayPlus

   הכתובת היא https://myaccount.payplus.co.il, ולחשבון בדיקות https://myaccountdev.payplus.co.il. אם עוד לא קיבלתם חשבון, פנו ל‑PayPlus ובקשו גישה למסך הניהול; זה לא משהו שאנחנו יכולים לפתוח עבורכם.

   זו לא הכתובת שמופיעה במסמכי ה‑API. restapi.payplus.co.il היא הכתובת שהמערכות מדברות אליה, לא מסך שנפתח בדפדפן. אם ניסיתם להיכנס לשם וקיבלתם דף ריק או שגיאה — זו הסיבה.

   

2. הגדרות ← התממשקות באמצעות API

   בעמוד ההגדרות יש כרטיס בשם "התממשקות באמצעות API". הוא מוביל למסך "הגדרות | API", ושם נמצאים שני מזהים באורך 36 תווים עם מקפים: API Key ו‑Secret Key.

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

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

   

3. דפי תשלום ← אייקון ההעתקה בשורה

   צריך דף תשלום אחד. אם אין לכם — לחצו "יצירת דף חדש", השם לא משנה.

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

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

   

4. הדביקו אצלנו ולחצו "בדיקת חיבור"

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

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

1. היכנסו למסך הניהול של Hyp

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

   מקום לצילום מסך מסך הכניסה של Hyp. שמרו בשם /guide/hyp-1-login.png

2. הגדרות ← דף תשלום ו‑API ← אימות

   משם צריך שלושה ערכים: מספר המסוף (Masof) — מספר בן 8–10 ספרות, KEY (מפתח ה‑API), ו‑PassP (סיסמת ה‑API). שני האחרונים מופיעים יחד באזור אימות.

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

   PassP היא לא סיסמת הכניסה לפורטל. זו סיסמה נפרדת שמיועדת לממשק ה‑API. אם תדביקו את סיסמת הכניסה, החיבור ייכשל (Hyp מחזירים קוד 902, "שגיאת אימות").

   מסוף שמספרו מתחיל ב‑00100 הוא מסוף בדיקות: אפשר "לשלם" בו עם כרטיס הבדיקה של Hyp (5253360311315452, תוקף 12/29, CVV 493, ת.ז. 890108558) בלי שאף אחד מחויב. כשעוברים למסוף האמיתי, מחליפים את שלושת הערכים יחד.

   מקום לצילום מסך מסך ה‑API עם שלושת השדות. טשטשו את KEY ואת PassP. שמרו בשם /guide/hyp-2-api.png

3. באותו מסך: הפנייה לאחר עסקה ← עסקה שהצליחה

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

   https://qder.ai/api/pay/return

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

   מקום לצילום מסך אזור "הפנייה לאחר עסקה" עם הכתובת שלנו בשדה "עסקה שהצליחה". שמרו בשם /guide/hyp-3-return.png

4. אם בדיקת החיבור אומרת שהדומיין חסום

   הסיבה הנפוצה היא KEY שהועתק לא נכון: Hyp חותמים גם עם מפתח שגוי, ורק דף התשלום עצמו נכשל עם "שגיאת אימות HTTP REFERER". העתיקו את ה‑KEY שוב ונסו.

   אם עם ה‑KEY הנכון הבדיקה עדיין נכשלת, המסוף שלכם מגביל אילו אתרים פותחים דרכו דף תשלום. בקשו מהתמיכה של Hyp להוסיף ל‑REFERER המורשה של המסוף את qder.ai ואת chat.qder.ai (הסועדים משלמים משניהם).

5. הדביקו אצלנו ולחצו "בדיקת חיבור"

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

1. היכנסו למסך הניהול של Grow

   Grow היא החברה שנקראה בעבר משולם. נכנסים עם המשתמש של בית העסק, בכתובת my.meshulam.co.il או דרך אפליקציית Grow Business.

   מקום לצילום מסך מסך הכניסה של Grow. שמרו בשם /guide/grow-1-login.png

2. דפי תשלום ← בחרו דף (או צרו חדש) ← הגדרות / חיבור API

   משם צריך שני ערכים: מזהה המשתמש (userId) של בית העסק ו‑קוד דף התשלום (pageCode). שניהם מחרוזות של אותיות ומספרים, ואף אחד מהם אינו סיסמה.

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

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

   מקום לצילום מסך הגדרות דף התשלום עם userId ו‑pageCode. שמרו בשם /guide/grow-2-page.png

3. רוצים לבדוק לפני שגובים כסף אמיתי?

   בקשו מהתמיכה של Grow פרטי Sandbox: הם נותנים userId ו‑pageCode נפרדים לסביבת הבדיקות, שבה אפשר "לשלם" בלי שכרטיס באמת מחויב. הדביקו אותם אצלנו ובחרו סביבה "בדיקות (Sandbox)". כשמחליפים לפרטים האמיתיים, מחליפים גם את הסביבה ל"ייצור".

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

4. הדביקו אצלנו ולחצו "בדיקת חיבור"

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

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

1. היכנסו למסך הניהול של Cardcom

   בכתובת secure.cardcom.solutions, עם המשתמש של בית העסק. דף התשלום שאנחנו פותחים לסועד הוא "פרופיל נמוך" (Low Profile), ולכן המודול הזה צריך להיות פעיל בחשבון שלכם. אם הוא לא, בקשו מ‑Cardcom להפעיל אותו.

   מקום לצילום מסך מסך הכניסה של Cardcom. שמרו בשם /guide/cardcom-1-login.png

2. מספר המסוף ושם המשתמש של הממשק

   מספר המסוף (TerminalNumber) הוא המספר הפנימי של המסוף ב‑Cardcom, לא מספר שב״א. שם המשתמש של הממשק (ApiName) נוצר תחת הגדרות ← משתמשי API: מחרוזת של כ‑20 תווים. אצל Cardcom זה מה שמאמת אתכם, ולכן אנחנו שומרים אותו כסוד.

   סיסמת API (ApiPassword) לא חובה. Cardcom דורשים אותה רק לזיכויים. עם הסיסמה אפשר להחזיר כסף לכרטיס ישר ממסך הסניף; בלעדיה מחזירים במסוף של Cardcom ומסמנים אצלנו שהוחזר.

   מקום לצילום מסך מסך משתמשי ה‑API עם שם המשתמש. טשטשו את המחרוזת. שמרו בשם /guide/cardcom-2-api.png

3. רוצים לבדוק לפני שגובים כסף אמיתי?

   ל‑Cardcom יש מסוף בדיקות, מסוף 1000. את שם המשתמש של הממשק אליו מבקשים מהתמיכה למפתחים של Cardcom (הם כבר לא מפרסמים אותו). כרטיס הבדיקה הוא 4580280000000008, תוקף עתידי, CVV 123, וכל ת.ז. עסקאות מתחת ל‑₪5,000 מאושרות ומעליו נדחות.

4. הדביקו אצלנו ולחצו "בדיקת חיבור"

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

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

1. שם המסוף

   זה שם המשתמש של הטרמינל שלכם ב‑Tranzila, אותו שם שמופיע בכתובת דף התשלום: directng.tranzila.com/<שם המסוף>/.

   מקום לצילום מסך מסך הכניסה של Tranzila עם שם הטרמינל. שמרו בשם /guide/tranzila-1-login.png

2. בקשו מ‑Tranzila מפתחות API (App Key ו‑Secret)

   דף התשלום של Tranzila מודיע על תשלום בלי חתימה, ולכן לפני שאנחנו סוגרים שולחן אנחנו שואלים את Tranzila עצמם, דרך ממשק הדוחות שלהם, אם העסקה באמת אושרה ובאיזה סכום. הממשק הזה דורש שני מפתחות: App Key ו‑Secret. מקבלים אותם מ‑Tranzila בהצטרפות ל‑API Services; בקשה קצרה לתמיכה שלהם.

   ה‑Secret הוא סוד. אצלנו הוא נשמר מוצפן ומשמש רק לחתימה על השאילתה מול Tranzila. אל תשלחו אותו במייל או בוואטסאפ.

3. הגדירו את שדה 20 כשדה DCdisable

   ב‑my.tranzila: הגדרות המסוף ← שדות נוספים לעסקה (Additional Fields for Transaction). הגדירו את שדה 20 כשדה DCdisable, במסוף האב ובמסוף הבן אם יש. דרכו התשלום חוזר אלינו עם המזהה של החשבון בשולחן; בלעדיו הכסף עובר אבל השולחן לא נסגר לבד. בדיקת החיבור בודקת שהשדה מוגדר.

4. בהגדרות המסוף: דף תשלום ← אבטחה

   ודאו ש‑Notify Format מוגדר QSTR, כדי ש‑Tranzila ישלחו לנו את ההודעה בפורמט שאנחנו קוראים. את כתובת ה‑Notify עצמה אנחנו מעבירים בכל תשלום, אין צורך לכתוב אותה שם.

   Handshake (נעילת סכום מראש) יכול להישאר מופעל: לכל דף תשלום אנחנו מבקשים מ‑Tranzila אסימון לסכום המדויק, ואחרי התשלום מאמתים את הסכום מול הדוח שלהם.

5. הדביקו אצלנו ולחצו "בדיקת חיבור"

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

1. היכנסו ל‑Client Portal של Rapyd

   עם משתמש בהרשאת Owner או Administrator. תחת Developers ← API access control נמצאים שני המפתחות: Access Key ו‑Secret Key. לסביבת הבדיקות (Sandbox) ולייצור יש מפתחות נפרדים; המתג בראש הפורטל מחליף ביניהם.

   ה‑Secret Key הוא סוד. אצלנו הוא נשמר מוצפן ומשמש רק לחתימה על כל פנייה ל‑Rapyd. אל תשלחו אותו במייל או בוואטסאפ, ואל תגדירו רשימת IP מותרים: הפניות מגיעות מהרשת של Cloudflare, שאין לה כתובת קבועה.

2. כתובת ה‑Webhook

   תחת Developers ← Webhooks ← Management, בחרו Edit URL והדביקו https://qder.ai/api/pay/rapyd/webhook, וסמנו את האירועים Payment Completed ו‑Payment Succeeded (כרטיס ישראלי נסגר אצל Rapyd רק למחרת, ו‑Payment Succeeded מגיע כבר ביום התשלום). כך שולחן נסגר גם כשהסועד שילם ונעל את הטלפון לפני שחזר לדף. אנחנו לא סומכים על ההודעה לבדה: לפני שהשולחן נסגר אנחנו שואלים את Rapyd, בפנייה חתומה, אם התשלום אכן נסגר ובאיזה סכום.

3. רוצים לבדוק לפני שגובים כסף אמיתי?

   בחרו אצלנו סביבה "בדיקות (Sandbox)" עם מפתחות הבדיקה. כרטיס הבדיקה של Rapyd הוא 4111111111111111, תוקף עתידי וכל CVV. לפני מעבר לייצור Rapyd מאמתים את העסק (KYB) בתוך הפורטל.

4. הדביקו אצלנו ולחצו "בדיקת חיבור"

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

מה אנחנו שומרים, ומה לא

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