整合商必須實作網站代管商,將使用者重新導向,以便進行儲值。此儲值是不同的形態,但用途與 Android 儲值提供的儲值相同。網站代管商必須為適合行動裝置的網站。
網站代管商必須根據使用者代理程式標頭值,判斷行動版網站要求和電腦版網路要求。使用行動網頁要求傳送的網頁必須適用於 Android 和 iOS 的行動版網站。除了使用者代理程式標頭值之外,用戶端不會提供其他提示,讓您瞭解使用者提出要求的環境 (電腦或網頁)。
伺服器必須使用 GET 導入 HTTPS 通訊協定。整合商可以定義路徑和主機,整合商必須支援 2,048 個半形字元的網址。包括配置、主機、通訊埠、路徑和參數。
所有參數都會先以 UTF-8 編碼,再進行網址編碼。
要求
收到要求後,Google 會提供以下項目做為網址參數:
欄位 | |
---|---|
gspMajorVersion
|
int
此要求的主要版本號碼。 |
gspTopUpRequest
|
TopUpRedirectRequest
儲值要求。 |
gspAssociationId
|
string
包含整合商用來查詢使用者註冊帳戶憑證的 ID。這是在 AssociateAccountRequest 中連結帳戶時傳送的關聯 ID。 |
gspCallbackUrl
|
string
用於將使用者重新導向的網址,以便完成 Google 上的儲值流程。這個值經過網址編碼。 |
回應
儲值完成之後,您必須使用 HTTPS GET 將使用者重新導向至 gspCallbackUrl
。這個網址必須包含下列查詢參數:
欄位 | |||||||
---|---|---|---|---|---|---|---|
gspResult
|
int
|
||||||
redirectRequestId |
string 必要項目:在原始/發起重新導向付款要求中傳送的 requestId 。Google 會驗證是否與已傳送的 requestId 相符,若兩者不符,「完整重新導向」流程將會失敗。
|
||||||
gspTopUpResponse |
必要項目: TopUpRedirectResponse 應使用 PGP 或 JWE+JWS 加密及簽署。此外,這個值應為具網路安全的 base64 編碼。 |