משלבים חייבים להטמיע מארח אתרי אינטרנט כדי להפנות את המשתמשים למטרות הוספת כסף. הוספת הכסף היא שיטה שונה, אבל אותה מטרה כמו הוספת הכסף שסופק על ידי הוספת כסף ל-Android. למארח האינטרנט הזה חייב להיות אתר שמתאים לניידים.
מארח אתרי האינטרנט חייב לקבוע את בקשות האינטרנט לנייד לעומת בקשות האינטרנט למחשבים על סמך ערך הכותרת של הסוכן המשתמש. הדף שנמסר בבקשות אינטרנט לנייד חייב להיות ידידותי לאינטרנט לנייד ב-Android וב-iOS. מלבד ערך הכותרת של סוכן המשתמש, הלקוח לא יספק לכם רמז נוסף לגבי הסביבה שבה המשתמש מבצע את הבקשה (מחשב או אינטרנט).
השרת חייב ליישם פרוטוקול HTTPS באמצעות GET. מבצע השילוב יכול להגדיר את הנתיב והמארח. מבצע השילוב חייב לתמוך באורכים של כתובות URL של 2,048 תווים. זה כולל את הסכמה, המארח, היציאה, הנתיב והפרמטרים.
כל הפרמטרים יהיו בקידוד UTF-8 לפני קידוד כתובות URL.
בקשה
אם תתקבל בקשה לכך, Google מספקת את הפרטים הבאים כפרמטרים של כתובות URL:
| שדות | |
|---|---|
gspMajorVersion
|
int
מספר הגרסה הראשית לבקשה הזו. |
gspTopUpRequest
|
TopUpRedirectRequest
בקשה להוספת כסף. |
gspAssociationId
|
string
מכילה מזהה שמשמש את מבצע השילוב כדי לחפש את פרטי הכניסה לחשבון שהמשתמש מוסיף. זהו מזהה השיוך שנשלח במהלך קישור החשבונות ב-AssociateAccountRequest. |
gspCallbackUrl
|
string
כתובת ה-URL שאליה יש להפנות את המשתמש כדי להשלים את תהליך הוספת הכסף ב-Google. הערך הזה מקודד בכתובת ה-URL. |
תשובה
בסיום הוספת הפרטים, המשתמשים צריכים להפנות אותם לכתובת gspCallbackUrl באמצעות HTTPS GET. כתובת ה-URL הזו חייבת לכלול את הפרמטרים הבאים של השאילתה:
| שדות | |||||||
|---|---|---|---|---|---|---|---|
gspResult
|
int
|
||||||
| redirectRequestId |
string חובה: מספר requestId שנשלח בבקשת התשלום המקורית או שהתחילו להשתמש בהפניה אוטומטית. Google תאמת שהשדה הזה תואם לrequestId שנשלח, ותהליך ההפניה המלאה ייכשל אם הוא לא יהיה תואם.
|
||||||
gspTopUpResponse |
חובה: המסמך TopUpRedirectResponse צריך להיות מוצפן ולחתום באמצעות PGP או JWE+JWS. כמו כן, הערך הזה צריך להיות מקודד base64 שהוא בטוח לאינטרנט. |
||||||