התממשקות לריווחית

התממשקות עם מערכת ריווחית (Rivhit)

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

קבלת מזהה API (API Token)

כדי להתממשק עם מערכת ריווחית, יש לקבל את מזהה ה-API (API Token) הייחודי לחשבונכם. להלן השלבים לקבלת המזהה:

1. כניסה למערכת ריווחית

  - היכנסו למערכת ריווחית באמצעות שם המשתמש והסיסמה שלכם.

2. גישה להגדרות

דף קבלת טוקן API בריווחית

  - בתפריט הימני, לחצו על הגדרות (כפי שמופיע בתמונה המצורפת 📸).

3. מעבר להגדרות מערכת

  - בתפריט ההגדרות, יש לבחור באפשרות הגדרות מערכת בתחתית הרשימה.

4. הצגת API Token

  - במסך שנפתח, לחצו על "הצג API" (כפתור ירוק).
  - חלון קופץ יציג את ה-API Token הייחודי שלכם.

5. העתקת ה-API Token

  - העתקו את המפתח והשתמשו בו עבור התממשקות עם המערכת.
  - 🛑 אבטחה: אין לשתף את ה-API Token עם גורמים חיצוניים! שמרו עליו במקום מאובטח.

מזהים נוספים במערכת ה-API של ריווחית

בנוסף ל-API Token, מערכת ריווחית עושה שימוש במזהים ייחודיים (GUID) נוספים לצורך אינטראקציה עם ה-API:

• GroupPrivateToken – מזהה ייחודי של דף תשלום, המשמש ליצירת כתובת URL לדף תשלום חדש. אותו יש להעתיק למערכת שלנו
• SaleId – מזהה עסקה המתקבל לאחר יצירת עסקה במערכת iCredit, ומשמש לפעולות נוספות או לקבלת מידע על העסקה.
• SalePrivateToken – מזהה ייחודי המתקבל לאחר יצירת עסקה, ומשמש לפעולות נוספות או לקבלת מידע על העסקה.
• PublicSaleToken – מזהה המתקבל לאחר יצירת דף תשלום, ומשמש לקבלת מידע על העסקה לאחר השלמת החיוב.
• Token – אסימון ייחודי ומאובטח של כרטיס אשראי, המשמש לשמירת פרטי כרטיס הלקוח לחיובים עתידיים.

💡 הערה: כל המזהים במערכת הם בפורמט GUID ייחודי.

שימושים עיקריים ב-API של ריווחית

• שליחת חשבוניות דיגיטליות – יצירת ושליחת חשבונית באופן אוטומטי ללקוחות.
• קבלת פרטי תשלומים – שליפת מידע על עסקאות שהתבצעו דרך המערכת.
• ניהול לקוחות – יצירת ועדכון לקוחות במערכת ריווחית דרך ה-API.

קישורים נוספים

• ספקי סליקה במערכת
• ניהול ספקי סליקה במערכת