כניסה לחשבון:   מקבלי תשלומים  |  משלמים 03-8008729
מדריך התממשקות באתר אינטרנט

ההתממשקות למערכת פלא-פיי מורכבת מ-3 שלבים בסיסיים:
1. יצירת קוד כפתור תשלום
התחבר לחשבונך בפלא-פיי >> לחץ על "הטמעת פלא-פיי באתר" >> "יצירת כפתור תשלום"
בצע הגדרות לכפתור התשלום וקבל קודhtml מוכן.
העתק את הקוד והדבק אותו בדף הרלוונטי באתרך.
2. העברת הנתונים מאתרך לדף התשלום (בעגלת קניות/מוצרים משתנים בלבד)
אם יש באתרך עגלת קניות, או שסכום הרכישה משתנה בכל קניה, עליך להוסיף סקריפט מתחת לקוד כפתור התשלום, אשר יעביר באופן דינאמי את סכום הרכישה + פרטי הרכישה לדף התשלום, בהתאם למה שהלקוח בחר באתר.
3. הפעלת כפתור התשלום
חזור לחשבונך ולחץ על >> "הטמעת פלא-פיי באתר" >> "הפעלת כפתור תשלום".
הגדר את כתובת הדף/ים באתרך בהם הטמעת את קוד כפתור התשלום.
הגדר דפי נחיתה- הדפים אליהם יועבר הלקוח לאחר ביצוע התשלום, בהתאם לסטאטוס העסקה.
דוגמא לקוד כפתור תשלום:
קוד כפתור סטאטי – סכום קבוע
<form name="pelepayform"
action="https://www.pelepay.co.il/pay/paypage.aspx"
method="post"><INPUT TYPE="hidden" value="site1@site1.com"
NAME="business"><INPUT TYPE="hidden" value="240"
NAME="amount"><INPUT TYPE="hidden" value="_product"
NAME="description"><INPUT TYPE="hidden" value="12"
NAME="max_payments"><input type="image"
src="http://www.pelepay.co.il/btn_images/pay_button_4.gif"
name="submit" alt="Make payments with pelepay"></form>
קוד כפתור דינאמי – סכום משתנה (עגלת קניות)
<form name="pelepayform" action="https://www.pelepay.co.il/pay/paypage.aspx" method="post">
<INPUT TYPE="hidden" value="site1@site1.com" NAME="business">
<INPUT TYPE="hidden" value="" NAME="amount">
<INPUT TYPE="hidden" value="" NAME="orderid">
<INPUT TYPE="hidden" value="_chart_shopp" NAME="description">
<INPUT TYPE="hidden" value="12" NAME="max_payments"><input type="image" src="http://www.pelepay.co.il/btn_images/pay_button_4.gif" name="submit" alt="Make payments with pelepay"></form>
שליחת סכום העסקה ופרטי העסקה באופן דינאמי. יש למקם את הסקריפט מתחת לקוד כפתור התשלום
<script language="javascript">
document.pelepayform.amount.value= "";//put your chart total amount
document.pelepayform.orderid.value= "";//put your chart order id number
</script>
פירוט הפרמטרים של קוד כפתור התשלום:
Business - מזהה החשבון.
כתובת הדוא"ל של בעל החשבון המשמש לזיהוי החשבון המוטב בפלא -פיי
לדוגמא: <"INPUT TYPE="hidden" value="demo@myshop.co.il" name="business>

amount – סכום התשלום .
יש לשים לב כי זהו סכום התשלום המלא- כולל משלוח ומע"מ.
<"INPUT TYPE="hidden" value="100.00" NAME="amount>

max_payments - מספר תשלומים.
מספר התשלומים המקסימאלי שיינתן ללקוח לשלם עימו. ניתן להגדיר עד 12 תשלומים.
<"INPUT TYPE="hidden" value="3" NAME="max_payments>

orederid - מספר הזמנה (בעגלת קניות בלבד).
משתנה פנימי באתרך שניתן להשתמש בו כמזהה עסקה/הזמנה.
<"INPUT TYPE="hidden" value="165" NAME="orderid>

submit – סגנון כפתור התשלום.
ניתן להשתמש בכפתורי תשלום מוכנים של פלא-פיי המיוצגים עפ"י ערכים קבועים מראש, או להשתמש בכתובת יעד של תמונה באתר שלך.
<"input type="image" src="http://www.pelepay.co.il/btn_images/pay_button_1.gif" name="submit>

Description – פרטי התשלום.
פירוט המוצרים/שירותים לתשלום. שים לב כי ניתן להשתמש בערכים קבועים של פלא-פיי (כגון: רכישת מוצר באתר, פרסום באתר וכדומה) , או להזין טקסט חופשי על בחירתך.

** הערה חשובה על טקסט בעברית:
במידה וישנם ערכים בעברית והם לא מופיעים בדף התשלום, יש לשמור את הקובץ שבו מופיע קוד כפתור התשלום בפורמט UTF8.
פתח את הקובץ באמצעות<< notepad לחץ על save as >> שנה את הקידוד ל- UTF8 >> שמור.
לדוגמא: < "INPUT TYPE="hidden" value="פרטי העסקה" NAME="description>
הגדרת דפי תשלום
לאחר הטמעת קוד כפתור התשלום באתר, יש להתחבר לחשבון בפלא-פיי ולהזין את כתובת דף התשלום - כתובת הדף שבו הטמעת את כפתור התשלום.
אם לא תזין את כתובת דף התשלום, כפתור התשלום יציג הודעת שגיאה בלחיצה עליו.

התחבר לחשבונך >> "הטמעת פלא-פיי באתר" >> הפעלת כפתור תשלום >> הגדר דפי תשלום.
הגדרת דפי נחיתה
דפי הנחיתה הם הדפים באתרך אליהם יופנה הלקוח באופן אוטומטי מיד לאחר ביצוע התשלום, בהתאם לסטאטוס של העסקה.
קיימים 3 סוגי דפי נחיתה:

דף עסקה מאושרת
הדף אליו יועבר הלקוח במקרה שהתשלום שלו בוצע בהצלחה - אושר ע"י חברת האשראי
ראה דף לדוגמא: https://www.pelepay.co.il/defaulturl/success.aspx

דף עסקה שנכשלה
הדף אליו יועבר הלקוח במקרה שהתשלום שלו נכשל- נדחה ע"י חברת האשראי
ראה דף לדוגמא: https://www.pelepay.co.il/defaulturl/fail.aspx

דף עסקה שבוטלה
הדף אליו יועבר הלקוח במקרה שהוא לחץ על הכפתור ביטול במהלך ביצוע התשלום
ראה דף לדוגמא: https://www.pelepay.co.il/defaulturl/cancel.aspx

יש 2 אפשרויות להגדרת דפי הנחיתה:
1. בחשבון פלא-פיי
מיועד למי שיש לו דפי נחיתה קבועים וסטנדרטיים.
התחבר לחשבונך, היכנס ל-הפעלת כפתור תשלום ועדכן בשדות המתאימים את כתובות הדפים שלך.
מאוד פשוט ומהיר. אין צורך בידע טכני לשם כך.
2. בקוד כפתור התשלום
מיועד למי שזקוק לדפי נחיתה שונים לכל מוצר/שירות שהוא מוכר.
הוסף בקוד כפתור התשלום את הפרמטרים הבאים:

דף עסקה מאושרת-
input type="hidden" value="http://www.your-domain.co.il" name="success_return"

דף עסקה שנכשלה-
input type="hidden" value="http://www.your-domain.co.il" name="fail_return"

דף עסקה שבוטלה-
input type="hidden" value="http://www.your-domain.co.il" name="cancel_return"

התחבר לחשבונך >> "הטמעת פלא-פיי באתר" >> הפעלת כפתור תשלום >> הגדר דפי נחיתה.
הודעת ביצוע עסקה אוטומטית (אופציונאלי)
מנגנון זה מיועד מי שחשוב לו לקבל נתונים חוזרים של ביצוע עסקה בצורה יציבה ואמינה, מבלי להיות תלוי בגורמים חיצוניים כמו הדפדפן של הלקוח וכדומה.
כל שצריך לעשות הוא להזין כתובת דף באתרך שאליו יועברו הנתונים באופן אוטומטי לאחר ביצוע עסקה באתרך.
הנתונים יועברו מאחורי הקלעים באמצעות שרתי פלא-פיי ולא באמצעות הדפדפן.
כל שעליך לעשות לאחר מכן הוא לשאוב את הנתונים אליך ולעשות בהם כרצונך.
עסקה שנקלטה בהצלחה באתרך תציג הודעה- OK
עסקה שלא נקלטה אצלך תציג את מספר השגיאה שבגללה העסקה לא נקלטה (שרת נפל וכדומה).

יש 2 אפשרויות להגדרה של כתובת הדף לקבלת הנתונים:
1. בחשבון פלא-פיי
היכנס להפעלת כפתור התשלום בחשבונך ופשוט הזן בשדה הנדרש את כתובת הדף לקבלת הנתונים.
2. בקוד כפתור התשלום
הוסף לקוד כפתור התשלום את 2 הפרמטרים הבאים:
input type="hidden" value="http://www.your-domain.com" name="notify_url"
input type="hidden" value="1" name="active_notify_url"
notify_url - פרמטר זה הוא כתובת הדף אליו יישלחו פרטי העסקה.
active_notify_url - פרמטר זה מפעיל או מכבה את שליחת הנתונים. ערך 1- פעיל | ערך 0- כבוי

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

דוגמא לדף שאליו נשלחים נתונים של עסקה
https://www.pelepay.co.il/SandBox/IPN.aspx
פרמטרים חוזרים לאחר ביצוע עסקה
לאחר כל ביצוע עסקה מאושרת/נכשלה, אנו שולחים לדפי הנחיתה שלך את כל הפרמטרים של העסקה.
 
  index   -
מספר עסקה בפלא-פיי
  ConfirmationCode   -
מספר אישור לעסקה כפי שהתקבל מחברות האשראי
  Response   -

קוד התגובה כפי שהתקבל מחברות האשראי. שעברה בהצלחה תסומן ב-000
במקרה של כישלון עסקה יוחזר קוד אחר המסמל את סיבת השגיאה. רשימת הקודים

  amount   -
הסכום הכולל של העסקה
  orderid   -
מספר ההזמנה מעגלת הקניות (מיועד לעסקאות שבוצעו באמצעות עגלת קניות באתר)
  Firstname   -
השם הפרטי של הלקוח
  lastname   -
שם המשפחה של הלקוח
  email   -
כתובת הדוא"ל של הלקוח
  Phone   -
מספר הטלפון של הלקוח
  address   -
כתובת הלקוח
  payfor   -
פרטי העסקה. המוצרים/שירותים אותם רכש הלקוח
  custom   -
פרמטר חופשי הנקבע ע"י בעל האתר בהתאמה אישית. פרמטר זה מאפשר לשלוח לדף התשלום מידע לפי בחירתך, ולקבל אותו חזרה לדפי הנחיתה.

לדוגמא, דף הנחיתה לעסקה שעברה בהצלחה יראה כך:

https://www.pelepay.co.il/demo/successpage.aspx?index=6575&ConfirmationCode=0257440&Response=
000&amount=3.00&firstname=itzik&lastname=tal&payfor=product&email=itzik@pelepay.co.il&phone=
09-8898876&orderid=142&custom=mydata
מילוי אוטומטי של פרטי הלקוח: (אופציונאלי)
אם פרטי הלקוח כבר הוזנו באתרך (הלקוח רשום באתרך או מילא קודם לכן טופס), ניתן לבצע מילוי אוטומטי של פרטיו האישיים ובכך לחסוך לו את הזנת השדות פעם נוספת.
השימוש באפשרות המילוי האוטומטי מונעת סירבול מיותר ומקצרת משמעותית את זמן ביצוע התשלום של הלקוח.

השדות אותם ניתן למלא באופן אוטומטי בדף התשלום הם:
firstname - שם פרטי
lastname - שם משפחה
email - דוא"ל
phone - טלפון
address – כתובת

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

<input type="hidden" name="firstname" value="israel" />
<input type="hidden" name="lastname" value="israeli" />
<input type="hidden" name="phone" value="03-1234567" />
<input type="hidden" name="email" value=israel@israeli.com" />
<input type="hidden" name="address" value="tel aviv" />

** נתונים בעברית - במידה וישנם ערכים בעברית והם לא מופיעים בדף התשלום, יש לשמור את הקובץ שבו מופיע קוד כפתור התשלום בפורמט UTF8.
פתח את הקובץ באמצעות notepad >> לחץ על save as >> שנה את הקידוד ל- UTF8 >> שמור.