השלמת התהליך של ההפניה האוטומטית

כחלק מתשלום להפניה אוטומטית, המשתמשים יופנו לביצוע תשלום באתר של השותף. לאחר השלמת התשלום, צריך להפנות את המשתמש חזרה ל-Google דרך מבצע השילוב. אם התשלום הושלם בפורטל של המנפיק, צריך להפנות את המשתמש תחילה למחבר, והוא אמור להפנות אותו אל Google.

מבצע השילוב צריך להפנות את המשתמש אל callbackUrl, שהוא חלק ממטען הייעודי (payload) של Begin Redirect. מבצע השילוב צריך להטמיע פרוטוקול HTTPS באמצעות GET. הפרמטרים של GET, שמתוארים בפרמטרים של תגובה להפניה אוטומטית, יכילו פרטים על השלמת התשלום עבור הפניה אוטומטית.

מבצע השילוב חייב לתמוך באורכים של כתובות URL של 2,048 תווים. זה כולל את הסכמה, המארח, היציאה, הנתיב והפרמטרים. כל הפרמטרים יהיו בקידוד UTF-8 לפני קידוד כתובות URL.

תגובה להפניה אוטומטית

הנה דוגמה לכתובת ה-URL שאליה המשתמש יופנה אוטומטית כחלק מתהליך ההשלמה של הפניה אוטומטית (שנקראת גם 'תגובה להפניה אוטומטית'):

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE&paymentIntegratorAccountId=InvisiRedirectPaymentUSA_USD&redirectResponse=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVTUE9OU0VfUEFZTE9BRF9FWEFNUExFX1RIQVRfSVNfRU5DT0RFRF9XSVRIX2Jhc2U2NF9VUkwtU0FGRV9FTkNPRElORw==

הערך שמפוענח בכתובת ה-URL של הפרמטר redirectRequestId בדוגמה הזו הוא cmVxdWVzdDE. הערך שמפוענח בכתובת ה-URL של הפרמטר paymentIntegratorAccountId בדוגמה הזו הוא InvisiRedirectPaymentUSA_USD

הפרמטר redirectResponse מוצפן וחתום באמצעות PGP או JWE+JWS לפני שהוא מקודד בפורמט base64url.

פרמטרים של תגובה להפניה אוטומטית

תגובת HTTPS GET חייבת לכלול את הפרמטרים הבאים של השאילתה:

שדות
redirectRequestId	string חובה: הערך requestId שנשלח בבקשת התשלום המקורית או שבתהליך ההעברה הראשוני. Google תאמת שהנתונים האלה תואמים ל-requestId שנשלח, ותהליך ההפניה האוטומטית ייכשל אם הם לא יהיו תואמים.
paymentIntegratorAccountId	string REQUIRED: זהו מזהה החשבון של הכלי לשילוב תשלומים, שמזהה אילוצים חוזיים שקשורים לעסקה הזו.
redirectResponse	RedirectResponse חובה: הקוד RedirectResponse צריך להיות מוצפן ולחתום באמצעות PGP או JWE+JWS. בנוסף, הערך הזה צריך להיות מקודד base64 בבטחה לאינטרנט.