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

ניתן לבצע תשלומים עם הפניה לכתובת אחרת בשתי דרכים שונות:

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

2. המשתמש יבחר אמצעי תשלום (מנפיק) בתהליך הרכישה. במקרה הזה, Google תאכלס את issuerId בבקשה ולהפנות את המשתמש למטמיע. כאשר מבצע השילוב מקבל את הקוד, עליו להפנות את המשתמש באופן מיידי באתר/באפליקציה של המנפיק כדי להשלים את הרכישה.

הערה: משלב התשלומים והמנפיק יכולים להיות אותה ישות.

בשני המקרים שלמעלה, Google תפנה את המשתמש ישירות אל אתר של השילוב ללא קריאה קודמת משרת-לשרת מ-Google.

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

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

בקשה להפניה מחדש

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

https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H

בדוגמה הזו, הערך של הפרמטר callbackUrl מפוענח בעזרת כתובת URL הוא:

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE

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

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

בקשת ה-GET GET צריכה לכלול את הפרמטרים הבאים של השאילתה:

שדות
callbackUrl	string כתובת URL להפניה אוטומטית של המשתמש לאחר השלמת תשלום. הערך הזה מקודד בכתובת URL ואורכו 512 תווים לכל היותר. כתובת ה-URL הזו תכלול את requestId מהקובץ המוצפן redirectRequest ב-GET של redirectRequestId הפרמטר. הספק צריך לאמת redirectRequestId מ-callbackUrl ומ- requestId מהמטען הייעודי (payload) המוצפן זהים ל- ששניהם קשורים.
redirectRequest	RedirectRequest חובה: RedirectRequest צריכים להיות מוצפנים וחתומים באמצעות PGP או JWE+JWS. כמו כן, הערך הזה צריך להיות בטוח לשימוש באינטרנט בוצע קידוד של base64.