מנוי וחיובים
חיבור ספק סליקה לקבלת תשלום מלקוחות
אילו פרטים צריך מכל ספק, איפה משיגים אותם ומה לבקש מהתמיכה.
- 1פותחים חשבון אצל אחד הספקים שאנחנו תומכים בהם — קארדקום, טרנזילה, Grow או PayPal. החשבון הוא שלכם, מול הספק, והכסף נכנס ישירות אליו ולא דרכנו.
- 2משיגים מהספק את פרטי החיבור ל-API. אלה לא שם המשתמש והסיסמה שאיתם אתם נכנסים לממשק שלו, אלא פרטים נפרדים לחיבור של מערכת חיצונית. לכל ספק יש למטה את הפרטים המדויקים שהוא דורש.
- 3בפאנל: הגדרות העסק ← קבלת תשלום מלקוחות. בוחרים ספק, מזינים את הפרטים ולוחצים ״שמירה ובדיקת חיבור״.
- 4אם הבדיקה חזרה תקינה, מדליקים את המתג ״קבלת תשלום אונליין״. רק אז הלקוחות רואים תשלום באתר.
- 5אפשר לחבר יותר מספק אחד — למשל כרטיס אשראי ו-PayPal. כששניהם פעילים, הלקוח בוחר באיזה מהם לשלם.
קארדקום
צריך מספר מסוף (TerminalNumber) ושם משתמש API (ApiName). סיסמת API אינה חובה אצלנו — לפי התיעוד של קארדקום היא נדרשת לזיכויים ולהפקת מסמכים.
- 1נכנסים לממשק הניהול של קארדקום.
- 2פותחים את Settings ← 1. Company setup ← 4. Manage API-keys.
- 3משם מעתיקים את מספר המסוף ואת שם המשתמש ל-API, או מבקשים שקארדקום תשלח אותם למייל הרשום.
שמות פריטי התפריט מופיעים כאן באנגלית, כי כך הם כתובים בתיעוד של קארדקום. לא אימתנו איך הם נקראים כשהממשק בעברית — חפשו את הסעיף של מפתחות ה-API תחת הגדרות החברה.
לא אימתנו אם לכל מסוף יש מפתח נפרד. אם יש לכם יותר ממסוף אחד, ודאו מול התמיכה שהעתקתם את הפרטים של המסוף הנכון.
טרנזילה
צריך את שם המסוף שטרנזילה הקצתה לעסק, ושני מפתחות: App Key ו-Secret.
- 1מוודאים מה שם המסוף שלכם — המזהה שמופיע בהתכתבות מול טרנזילה.
- 2פונים לטרנזילה ומבקשים הרשמה לשירותי ה-API וקבלת שני המפתחות. התיעוד שלהם כותב במפורש שהמפתחות מתקבלים מטרנזילה.
- 3כשהמפתחות מגיעים, מעתיקים אותם יחד עם שם המסוף למסך ההגדרות.
לא אימתנו שיש מסך בממשק הסוחר להפקה עצמית של המפתחות. עברנו על התיעוד ועל עמוד התמיכה ולא נמצא נתיב כזה, ולכן הדרך היא פנייה אליהם. אם תראו סעיף API בממשק — אפשר להשתמש בו.
לטרנזילה יש גם שיטת חיבור ישנה עם שם מסוף וסיסמה. אצלנו משתמשים בשיטה עם המפתחות, אז סיסמת המסוף לא נדרשת כאן.
Grow (לשעבר משולם)
צריך מזהה משתמש (userId) וקוד עמוד תשלום (pageCode). מפתח API נדרש רק לחברה שמבצעת תשלומים עבור עסקים אחרים, ולכן הוא לא חובה אצלנו.
- 1פונים לתמיכה של Grow ומבקשים הרשאות API ואת המזהים של העסק.
- 2אם יש לכם יותר מאמצעי תשלום אחד ב-Grow, אומרים להם לאיזה אמצעי אתם מחברים את האתר — לכל אחד יש pageCode משלו.
- 3מבקשים במפורש את המזהים של הסביבה החיה. למזהי סביבת הבדיקות יש ערכים אחרים.
לא אימתנו שהמזהים מוצגים בממשק הסוחר של Grow. התיעוד מפנה לתמיכה בלבד.
לפי התיעוד, המזהים של הסביבה החיה נמסרים רק אחרי שהבדיקות מול Grow הושלמו.
PayPal
צריך Client ID ו-Secret מאפליקציית REST, ולסמן אם הם של הסביבה החיה או של סביבת הבדיקות. לפי התיעוד של PayPal נדרש חשבון Business — חשבון פרטי לא מספיק.
- 1נכנסים ללוח המפתחים של PayPal ומתחברים עם פרטי חשבון ה-PayPal של העסק.
- 2בוחרים Apps & Credentials, ואז Live או Sandbox לפי מה שאתם מחברים. לכל סביבה יש אפליקציות ופרטים נפרדים.
- 3בחשבון חדש כבר קיימת Default Application תחת REST API apps. לאפליקציה חדשה בוחרים Create App, נותנים שם וסוג Merchant.
- 4בעמוד האפליקציה מוצגים Client ID ו-Secret. מעתיקים את שניהם למסך ההגדרות, ומסמנים שם אם הם של סביבת בדיקה.
אל תערבבו בין הסביבות: מפתחות של Sandbox לא יגבו כסף אמיתי, ולהיפך.
לא אימתנו באילו מטבעות חשבון עסקי ישראלי יכול לקבל ולהחזיק כסף, ומה קורה כשלקוח משלם בשקלים. כדאי לשאול את PayPal לפני שמפעילים תשלום באתר.
בניגוד לשאר הספקים, כאן מפיקים את הפרטים לבד ואין ממי לבקש אותם. פונים לתמיכה רק כשיש בעיה בחשבון עצמו.
לא מוצאים פרט מסוים? אל תנחשו. בשיחה עם התמיכה אומרים: שם העסק ומספר העוסק, שאתם מחברים את חשבון הסליקה לאתר חדש, שאתם צריכים את פרטי החיבור ל-API ולא את סיסמת ההתחברות, ושאתם צריכים את הסביבה החיה.
בקשו שהפרטים יישלחו למייל הרשום של העסק או דרך הממשק, ולא בהודעה פתוחה.
פרטי החיבור הם כמו סיסמה: לא שולחים אותם בקבוצות ולא מוסרים למי שלא עובד אצלכם. אם נדמה לכם שנחשפו, בקשו מהספק להחליף אותם.
הבדיקה שלנו לא מחייבת אף אחד בכסף — היא רק שואלת את הספק אם הוא מזהה את הפרטים. בדיקה שעברה לא מעידה שהחשבון אצלו כבר מאושר לגבייה.
הפרטים נשמרים מוצפנים אצלנו, לא מוצגים שוב אחרי השמירה, ולא נכללים בייצוא של לקוחות או הזמנות. אנחנו לא מבקשים את סיסמת החשבון שלכם אצל הספק ולא אוספים מספרי כרטיס של הלקוחות.