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

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

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

  2. המשתמש יבחר אמצעי תשלום (מנפיק) במהלך תהליך הרכישה. במקרה כזה, 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 הזו תכלול את requestId מה-redirectRequest המוצפן בפרמטר redirectRequestId GET. הספק צריך לאמת שהערכים redirectRequestId מ-callbackUrl ו-requestId ממטען הייעודי (payload) המוצפן זהים כדי לאמת ששניהם קשורים.

redirectRequest RedirectRequest

חובה: הקוד RedirectRequest צריך להיות מוצפן ולחתום באמצעות PGP או JWE+JWS. בנוסף, הערך הזה צריך להיות מקודד base64 בבטחה לאינטרנט.