使用者禮物卡註冊

禮物卡註冊 (登入) 功能可讓使用者搜尋 將禮物卡新增至 Google 錢包。 系統會將使用者導向至行動裝置適用的網站,以便完成 程序完成後,即可將卡片新增至 Google 錢包。

本指南將概略說明必要的實作步驟 為您的禮物卡計畫啟用這項功能。

總覽

首先,請確認您先前已設定專案,並已取得 Google Wallet API。

您必須按照下列四個步驟實作登入功能 享有以下福利:

  1. 在 Google 錢包中設定測試類別,以便測試登入流程。
  2. 開發使用 Google 錢包 SharedDataType 的登入頁面。
  3. 實作在登入後將禮物卡退回至 Google 錢包的功能。
  4. 要求驗證及啟用。

在 Google 錢包中設定測試類別

確定登入網址,也就是您的程式標誌。接著: 請使用 discoverableProgram 巢狀欄位的 giftcardclass 能設定 適當的值。

設定 discoverableProgram 中的值,建立應用程式的草稿版本 提供登入功能的禮物卡計畫。為確保測試人員能看到這項內容,請確認測試人員 測試人員可存取你的 Google Pay 和錢包主控台。想進一步瞭解如何分享 Google Pay 和錢包主控台對其他使用者的存取權, 瞭解「使用者」頁面

在開發期間完成導入功能驗證 程序,請使用 Google Pay 和錢包主控台中的「聯絡支援」小工具與我們聯絡。在 在控制台中選取主題中的「Google Wallet API」,然後依序選取「禮物卡登入」 次主題。

開發使用 Google 錢包使用者資料的登入頁面

使用者選擇新增禮物卡時 將使用者帶往你網站上的專屬網頁,以便完成 登入程序。

您必須提供登入網址,供使用者登入 新增至現有帳戶

登入頁面必須符合下列規定:

  • 提供適合行動裝置的使用者體驗。
  • 讓使用者在單一頁面中完成登入程序。
  • 使用有效憑證並採用「HTTPS」加密,確保使用者資料安全無虞 安全傳輸
  • 確保登入頁面的運作時間至少為 99.9%。

顯示登入網頁時,Google 錢包會建立 系統會向您提供的POST 網址。系統會在參數 SharedDataType 中提供使用者資料 這個要求包含在 POST 要求中 application/x-www-form-urlencoded 內容類型,和 UTF-8 編碼。SharedDataType 的值 參數是採用 Base64 編碼的 JSON 物件。

實作可立即推送禮物卡至 Google 錢包的功能

驗證 (登入) 後,您的網頁 應立即將使用者的禮物卡推送回 Google 錢包。

如要將禮物卡退回 Google 錢包,請重新導向至 與您聯繫

https://pay.google.com/gp/v/save/{jwt_generated}

網址的長度上限為 2,000 個字元。您的連結 少於此上限透過編碼編入 JWT 中的物件應精簡,且僅包含 個別使用者專屬的資料請試著將大部分資料存放在物件的類別中, 來建立值區。若是超出字元限制的大型物件,請考慮 首先在 Google Wallet API,並僅傳送 JWT 中的物件 ID。

一般通訊流程

使用者完成登入程序的通訊流程如 下方圖片。「您的伺服器」間的所有動作您必須負責實作

登入流程

要求驗證與啟用

完成開發工作並測試登入流程後,請提交要求 透過 Google Pay 和錢包主控台聯絡支援團隊

全面檢查實作內容,確認功能正常運作 卡片登入功能就會與 Google 錢包應用程式合併 在您的禮物卡計畫公開推出。這樣一來,任何使用者都能看到 並使用這個功能

為提供最佳使用者體驗,請定期檢查登入活動 。 如果資料不一致且登入功能存在,我們會通知您 直到問題解決為止。

常見問題

  • 禮物卡計畫中使用的圖片是否有任何規定?
    • 是,您的圖片必須代管於 HTTPS 個位置 因為停用後,就不會出現在 Google 錢包中。
  • 是否有任何工具能簡化 JWT 的實作和偵錯作業?
    • 是,例如 www.jwt.io 可讓您解碼 並在開發過程中對權杖偵錯,讓您可以 提交內容。請注意,Google 與 AdSense 無關, 特別推薦採用這類第三方的服務。
  • 我們如何正確處理採用 Base64 編碼的 SharedDataType 資料?
    • 確認你在整個過程中都採用 UTF-8 編碼。JSON 字串 開頭是 UTF-8 編碼,隨後則使用 android.util.Base64 以及 NO_WRAP 和 URL_SAFE 選項。這與 RFC 3548 第 4 節