ניתן לבצע תשלומים של הפניה אוטומטית בשתי דרכים שונות:
כשהמשתמש יבחר באפשרות Redirect payment (תשלום להפניה אוטומטית), הוא יופנה לאתר של השילוב כדי לבחור באמצעי התשלום שבו ייעשה שימוש. במקרה הזה, הערך
noFopChosen
יאוכלס בבקשה. כשזה קורה, מבצע השילוב יציג למשתמש רשימה של המנפיקים הזמינים. אחרי שהמשתמש בוחר באחת מהאפשרויות האלה, הוא מועבר לאתר או לאפליקציה של המנפיק כדי להשלים את הרכישה.המשתמש יבחר אמצעי תשלום (מנפיק) במהלך תהליך הרכישה. במקרה כזה, Google תאכלס את הפרמטר
issuerId
בבקשה ותפנה את המשתמש למבצע השילוב. כשהשלב מקבל את הפרטים האלה, הוא צריך להפנות את המשתמשים באופן מיידי לאתר או לאפליקציה של המנפיק כדי להשלים את הרכישה.
בשני המקרים שלמעלה, Google תפנה את המשתמש ישירות לאתר של מבצע השילוב, ללא קריאה קודמת משרת לשרת מ-Google.
מבצע השילוב חייב להטמיע פרוטוקול HTTPS באמצעות GET. הפרמטרים GET, שמתוארים בפרמטרים של בקשה להפניה אוטומטית, יכללו מידע על התשלום המבוקש להפניה אוטומטית.
מבצע השילוב חייב לתמוך באורכים של כתובות URL של 2,048 תווים. זה כולל את הסכמה, המארח, היציאה, הנתיב והפרמטרים. כל הפרמטרים יהיו בקידוד UTF-8 לפני קידוד כתובות URL.
בקשה להפניה אוטומטית
הנה דוגמה לכתובת ה-URL שאליה המשתמש יופנה אוטומטית כחלק מתהליך ההתחלה של הפניה אוטומטית (שנקראת גם בקשה להפניה אוטומטית):
https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H
בדוגמה הזו, הערך המפוענח של כתובת ה-URL של הפרמטר callbackUrl
הוא:
https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE
הפרמטר redirectRequest
מוצפן וחתום באמצעות PGP
או JWE+JWS
לפני שהוא מקודד בפורמט base64url
.
פרמטרים של בקשות להפניה אוטומטית
בקשת ה-HTTPS GET חייבת לכלול את הפרמטרים הבאים של השאילתה:
שדות | |
---|---|
callbackUrl
|
string
כתובת URL להפניה אוטומטית של המשתמש לאחר ביצוע התשלום. הערך הזה מקודד בכתובת ה-URL והאורך המקסימלי שלו הוא 512 תווים.
כתובת ה-URL הזו תכלול את |
redirectRequest
|
RedirectRequest
חובה: הקוד |