העברת נתוני תשלום
מבוא
סקירה טכנית
מדריך
דוגמאות קוד


סקירה טכנית


העברת נתוני תשלום (PDT) מאפשרת לבעלי עסקים להציג את פרטי העסקה לקונים אשר מנותבים בחזרה לאתר שלהם עם השלמת התשלום.

כיצד זה עובד

מרגע שהפעלת את העברת נתוני התשלום (PDT), בכל פעם שקונה מבצע תשלום באתר ומנותב מחדש אל כתובת ה-URL לחזרה שלך, אסימון עסקה יועבר בתור משתנה "GET" לכתובת ה-URL לחזרה זו. על-מנת להשתמש כהלכה ב-PDT ולהציג את פרטי העסקה ללקוח שלך, עליך להחזיר את אסימון העסקה, שם משתנה "tx", ולאחזר את פרטי העסקה מ-PayPal על-ידי בניית HTTP POST ל-PayPal‏.

את ה-POST שלך יש לשלוח אל https://www.paypal.com/cgi-bin/webscr‏. עליך להציג את אסימון העסקה תוך שימוש במשתנה "tx" ובערך של אסימון העסקה שהתקבל קודם לכן (לדוגמה, "tx=transaction_token"), ואסימון הזיהוי המיוחד, תוך שימוש במשתנה at ובערך של אסימון זיהוי PDT שלך (לדוגמה, "at=identity_token"). תצטרך גם להוסיף משתנה ששמו "cmd" המכיל את הערך "_notify-synch", לדוגמה "cmd=_notify-synch", למחרוזת ה-POST‏.

PayPal תגיב ל-post במלה יחידה, SUCCESS או FAIL, בשורה אחת בגוף התגובה. כשתקבל את התגובה SUCCESS, יתר גוף התגובה יהיה פרטי עסקאות, אחת בכל שורה, בפורמט key=value, כאשר הערכים key ו-value יהיו שניהם מחרוזות URL מקודדות. את נתוני התגובה יש לנתח כהלכה ולאחר מכן לפענח את קוד האינטרנט.

דוגמה לתגובה שהצליחה:
SUCCESS‏
first_name=Jane+Doe‏
last_name=Smith‏
payment_status=Completed‏
payer_email=janiedoesmith@hotmail.com‏
3.99
mc_currency=USD‏
custom=For+the+purchase+of+the+rare+book+Green+Eggs+%26+Ham‏
...

אתה רשאי להציג ללקוח שלך פרטי תשלום כפי שתמצא לנכון; עם זאת, PayPal ממליצה לכלול את הכתובת למשלוח, הדואר האלקטרוני של המשלם והסכום ששולם. אם אתה משתמש בהעברת נתוני תשלום (PDT) כדי לקבוע מתי לממש הזמנה באופן אוטומטי, ודא שמצב התשלום 'הושלם', מכיוון שהקונה עשוי להשתמש בשיטות כגון המחאות אלקטרוניות שאינן עוברות סליקה מיידית.

אם אתה משתמש בנתונים אלה כדי לממש הזמנות, PayPal ממליצה ביותר שתפעיל הודעת תשלום מיידית כדי לקבוע אם התשלומים הממתינים הללו נוקו. לפרטים נוספים עיין במדריך הודעת התשלום המיידית של PayPal, אשר זמין באתר האינטרנט של PayPal‏.

אם התגובה היא FAIL, תוכל לנסות להחזיר שוב post אל PayPal כדי לברר אם הסיבה לכישלון היא שגיאת רשת; עם זאת, במקרה שגם הניסיון השני נכשל, PayPal ממליצה לבדוק את ה-script שלך ולחקור את הסיבה יותר לעומק.
  • ודא שהמשתנה txn_id אינו שכפול, כדי למנוע שימוש או שימוש-חוזר בעסקה ישנה, שהושלמה, על-ידי מישהו אחר.
  • ודא שהדואר האלקטרוני של המקבל הוא כתובת דואר אלקטרוני שרשומה בחשבון PayPal שלך, כדי למנוע מצב שהתשלום יישלח לחשבון של מבצע הונאה.
  • בדוק פרטי עסקה נוספים, כגון מספר הפריט והמחיר, כדי לאשר שהמחיר לא שוּנה.

משתני 'הודעת תשלום מיידית'

לרשימה מלאה של משתני 'הודעת תשלום מיידית' ולקבלת הנחיות מפורטות בנושא השימוש ב'הודעת תשלום מיידית', עיין במדריך האינטגרציה של Website Payments Standard‏

Adobe Acrobat‏ נדרש כדי לקרוא את מדריכי PayPal‏.