API - שידור עסקה אל מכשיר הסליקה באמצעות תוכנה חיצונית

Question

Accepted Answer

במבוא שלפניכם נסביר תחילה על הפרמטרים שהינם שדות חובה בכל פנייה אל דף התשלום של פיי פלוס

ולאחר מכן נתאר פרמטרים נוספים שנחשבים שימושיים

לפיי פלוס ישנם שני סביבות עבודה עיקריות

סביבת Test(Staging)- סביבת ניסיון:

https://restapidev.payplus.co.il/api/v1.0

וסביבת Production - סביבה אמיתית:

https://restapi.payplus.co.il/api/v1.0/PaymentPages/generateLink

באמצעות ה-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
נועד עבור פעולות חיוב/זיכוי - המסמך יופק ע"פ הגדרת סוג המסמך מתוך ממשק חשבונית +
*שימו לב: שירות זה הינו שירות נוסף הניתן בתוספת עלות - ניתן לרכישה באזור האישי ע"י לחיצה מצד ימין על שירות חשבונית +
שם תוכלו לבחור חבילה הרלוונטית ולהצטרף באופן דיגיטלי
רק לאחר אישור השירות , מספור המסמכים ושמירה ניתן להשתמש בשירות זה.