Web Top-Up API

整合商必須實作網站代管商,將使用者重新導向,以便進行儲值。此儲值是不同的形態,但用途與 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

100
儲值成功。
201 使用者手動取消流程,且應取消流程。
202 因嚴重原因導致儲值失敗,應取消流程。

redirectRequestId string

必要項目:在原始/發起重新導向付款要求中傳送的 requestId。Google 會驗證是否與已傳送的 requestId 相符,若兩者不符,「完整重新導向」流程將會失敗。
gspTopUpResponse RedirectResponse

必要項目TopUpRedirectResponse 應使用 PGPJWE+JWS 加密及簽署。此外,這個值應為具網路安全的 base64 編碼。