API - שידור עסקה אל מכשיר הסליקה באמצעות תוכנה חיצונית
במבוא שלפניכם נסביר תחילה על הפרמטרים שהינם שדות חובה בכל פנייה אל דף התשלום של פיי פלוס
ולאחר מכן נתאר פרמטרים נוספים שנחשבים שימושיים
לפיי פלוס ישנם שני סביבות עבודה עיקריות
סביבת Test(Staging)- סביבת ניסיון:
וסביבת Production - סביבה אמיתית:
באמצעות ה-API של פיי פלוס תוכלו לפנות לביצוע עסקה מהתוכנה שלכם אל מכשיר הסליקה שלנו באמצעות פנייה אל מזהה המכשיר
Reference<<Devices<<TransactionByDevice
ראו את הלינק המצורף: https://www.payplus.co.il/developers#/reference/0/devices/transactionbydevice
שדות חובה בכל פנייה - Required
-
תחת לשונית Attributes - תכונות:
-
device_uid - מזהה המכשיר - על מנת להעתיק את מזהה המכשיר
לחצו בממשק פיי פלוס על: הכפתור הירוק מצד שמאל למעלה<<בחרו הגדרות<<רשימת עמדות<<והעתיקו את המזהה מצד שמאל למכשיר המבוקש - charge_method אופי החיוב מאפיין את סוג החיוב בדף התשלום ומגדיר אותו כברירת מחדל , יש להגדיר את אופי החיוב על פי מספר ולהלן האפשרויות:
*סליקה רגילה( J4 Charge ) פרמטר 1 - שהינה כרטיס האשראי חיוב מידי / או עסקאות תשלומים
*סליקה באמצעות השהיית חיוב( J5 Approval ) פרמטר 2- חיוב מושהה - *תלויה באישור חברת האשראי שלכם
תופס מסגרת אשראי ללקוח ומאפשרת לכם לבחור מתי לחייב את הכרטיס (לדוגמא לאחר שביצעתם בדיקה שהפריט קיים במלאי)
*סליקה באמצעות חיוב מחזורי (Recurring Payments) פרמטר 3
*על מנת לעבוד בתצורה זו עליכם להוסיף מסוף הנתמך בממשק הוראות הקבע של פיי פלוס הנועד ליצירת חיוב מחזורי באופן אוטומטי בדף התשלום.
* בדיקה בלבד (J2) - פרמטר 0 -אפשרות זו מאפשרת לבדוק את תקינות תבנית כרטיס האשראי ואינה מבצעת עסקה מכיוון שאינה יוצרת כלל תקשורת עם המסוף הדיגיטלי. - amount סכום העסקה - יש להגדיר במספר את גובה הסכום לחיוב
- currency_code קוד המטבע - יש להגדיר string אחד - מבין המטבעות הבאים: ILS / USD / EUR / GBP / AUD / CAD
-
credit_terms - תנאי תשלום - יש להגדיר במספר -עסקה רגילה - 1, עסקת תשלומים - 8 , עסקה בקרדיט - 6
-
שדות שימושיים נוספים - Callback / Invoices ועוד
- refURL_callback - Callback מכיל מידע על שובר האשראי, לצורך כך תצטרכו לציין את כתובת ה-URL שלכם
פונקציית ה-Callback נועדה להשיב לכם מידע על העסקה בעת סיומה - עסקת חיוב/ או עסקת זיכוי שעברו בהצלחה.
לפונקציה ה-Callback יש דיליי קל אך נועדה לעבוד באופן אוטומטי על מנת להשיב אליכם את המידע על העסקה.
*פרמטר payment_request_uid ישלח אליכם רק אם העסקה בוצעה בהצלחה. - IPN FULL - Instant Payment Notification - קבלת מידע מידי על עסקה + חשבונית באופן מידי
מעוניינים לקבל מידע גם על עסקה וגם על חשבונית ובאופן מהיר יותר?
היכנסו אל הלינק המצורף :https://www.payplus.co.il/developers#/reference/0/payment-pages/ipn-full - create_token - יצירת טוקן - יש לבחור - True או False
שירות טוקנים נועדה על מנת לשמור את פרטי כרטיס האשראי באופן מוצפן במערכות פיי פלוס,
לצורך חיוב עתידי/מחזורי המתבצע באופן ידני על ידכם.
*שימו לב: שירות זה הינו שירות נוסף הניתן רק עבור משתמשים שרכשו שירות טוקנים והמסוף שלהם פטור מחובת CVV (באישור חברת האשראי בלבד).
שירות זה הינו שירות שעובד באופן ידני ולא באופן אוטומטי.
אם תהיו מעוניינים ליצור חיוב מחזורי שיחייב באופן אוטומטי - צרו קשר עם פיי פלוס למידע על ממשק הוראות הקבע Recurring Payments - initial_invoice - הפקת מסמך באופן אוטומטי לאחר ביצוע עסקה - יש לבחור True או False
נועד עבור פעולות חיוב/זיכוי - המסמך יופק ע"פ הגדרת סוג המסמך מתוך ממשק חשבונית +
*שימו לב: שירות זה הינו שירות נוסף הניתן בתוספת עלות - ניתן לרכישה באזור האישי ע"י לחיצה מצד ימין על שירות חשבונית +
שם תוכלו לבחור חבילה הרלוונטית ולהצטרף באופן דיגיטלי
רק לאחר אישור השירות , מספור המסמכים ושמירה ניתן להשתמש בשירות זה.
