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

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

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

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

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

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

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

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

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

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

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

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