במערכת קיימות מספר קריאות API לביצוע פעולות סליקה ותשלום. למרות שכולן קשורות לעולם האשראי, כל קריאה מיועדת לתרחיש שונה.
billing/payments/beginredirect
קריאה זו מיועדת לתהליך תשלום מלא הכולל גם הפקת מסמך במערכת.
הלקוח מועבר לדף תשלום חיצוני, מזין את פרטי האשראי, ובסיום התהליך ניתן להפיק מסמכים כגון חשבונית, קבלה, חשבונית מס קבלה, הצעת מחיר ועוד.
הקריאה מאפשרת להעביר פרטי לקוח, פריטים, מע"מ, מטבע ונתונים נוספים הקשורים למסמך.
מתאימה בעיקר למקרים שבהם התשלום והפקת המסמך מתבצעים כחלק מאותו תהליך.
creditguy/gateway/beginredirect
קריאה זו מיועדת לפעולות סליקה ושמירת כרטיס, ללא הפקת מסמך במערכת.
גם כאן הלקוח מועבר לדף תשלום חיצוני ומזין את פרטי האשראי, אך הפעולה שתתבצע תלויה ב-Mode שנבחר:
TokenizeOnly (0) - שומר את הכרטיס בלבד באמצעות טוקן.
ValidateCard (2) - בודק שהכרטיס תקף.
Charge (4) - מבצע חיוב של הלקוח, בלי ליצור מסמך.
Authorize (5) - שומר מסגרת לחיוב עתידי.
מתאימה בעיקר לתהליכי סליקה שאינם דורשים הפקת מסמך, או למצבים שבהם רוצים לשמור כרטיס לשימוש עתידי.
creditguy/vault/tokenize וקריאות tokenize נוספות
קריאות אלו מיועדות ליצירת טוקן כאשר פרטי הכרטיס נאספים על ידי העסק עצמו.
בניגוד לקריאות ה-Redirect, הלקוח אינו מועבר לדף תשלום חיצוני של SUMIT, אלא מזין את פרטי האשראי בממשק של העסק, והמערכת מחזירה טוקן שניתן להשתמש בו בהמשך.
הקריאות הנפוצות הן:
• /creditguy/vault/tokenize/ - יצירת טוקן לשימוש חוזר.
• /creditguy/vault/tokenizesingleuse/ - יצירת טוקן חד פעמי.
• /creditguy/vault/tokenizesingleusejson/ - יצירת טוקן חד פעמי בפורמט JSON.
מתאימות בעיקר למערכות המבצעות חיובים עתידיים או חוזרים באמצעות טוקן.
⚠️ שימו לב!
המידע בדף זה נועד לספק כיוון כללי לגבי מטרת הקריאות השונות. בחירת הקריאה המתאימה תלויה בתהליך העסקי, באופן איסוף פרטי האשראי ובדרישות הסליקה של המערכת שלכם.