使用者可透過會員方案註冊和登入功能,直接在 Google 錢包搜尋會員方案,並加入或登入帳戶。使用者會導向至適合行動裝置瀏覽的網站完成程序,之後即可將正式卡片新增至 Google 錢包。
必須先導入這項功能,才能將使用者新增的「靜態」票證轉換為「動態」API 連結票證。 本指南將概略說明相關優點,以及啟用會員方案註冊、登入和票證升級功能所需的導入步驟。
總覽
首先,請確認您已設定專案,並可存取 Google Wallet API。
您必須按照下列四個步驟實作這項功能:
- 設定測試類別:設定 Google 錢包,以便測試流程。
- 開發網頁:使用 Google 錢包
SharedDataType建立註冊/登入網頁。 - 建置推送機制:在使用者完成動作後,將會員卡傳送至 Google 錢包。
- 要求驗證:提交審查並要求啟用升級。
為什麼要導入會員註冊功能?
如要瞭解這項整合功能的價值,請務必區分 Google 錢包中的兩種票證類型:L1 (使用者新增) 和 L2 (合作夥伴核發)。
L1 和 L2 的差異
| 功能 | L1 票證 (使用者新增) | L2 憑證 (合作夥伴核發) |
|---|---|---|
| 來源 | 使用者手動掃描實體卡片或輸入卡號時建立。 | 使用者透過您的流程註冊或登入後,使用 Wallet API 建立並推送。 |
| 控制 | 靜態:合作夥伴無法查看或控管這張票證。 | 動態:合作夥伴可透過 API 完整控管。 |
| 功能 | 條碼的靜態圖片。設定完成後即無法更新。 | 可更新點數餘額、等級狀態、顯示個人化優惠,以及接收通知。 |
升級路徑:通往會員方案的「橋樑」
只要建立會員註冊流程 (「目的地」),Google 就能建立「橋梁」,將使用者從靜態 L1 票證升級為官方 L2 票證。主要有兩種升級觸發條件:
- L1 升級至 L2 票證:如果使用者先前曾手動新增卡片 (L1),Google 錢包會提示他們前往新的登入流程,升級至官方動態票證 (L2)。
- 升級從 Gmail 匯入的票證:如果 Google 錢包偵測到使用者的 Gmail 中有會員卡,就會提示使用者前往您的流程並進行驗證,以取得官方 L2 票證。
步驟 1:在 Google 錢包中設定測試類別
決定註冊和登入網址、計畫標誌,以及所選的使用者欄位。然後,使用 loyaltyclass 中的 discoverableProgram 巢狀欄位設定適當的值。
在 discoverableProgram 中設定值,建立啟用註冊/登入功能的會員方案草稿版本。為確保測試人員能看到這項資訊,請確認他們有權存取 Google Pay 和錢包主控台。如要進一步瞭解如何與他人共用 Google Pay 和錢包控制台的存取權,請參閱「瞭解『使用者』頁面」。
如要在開發過程中完成實作功能驗證,請使用 Google Pay 和錢包主控台中的「與支援團隊聯絡」小工具與我們聯絡。在控制台中,選取主題中的「Google Wallet API」,然後選取子主題中的「會員方案登入/註冊」。
步驟 2:建立註冊和登入頁面
使用者選擇登入或註冊你的會員方案時,系統會將他們導向至你網站上的專屬網頁,方便他們完成註冊或登入程序。如果使用者選擇註冊,Google 錢包就會要求使用者決定是否與你分享他們的使用者資料,並提供相關核准。
您必須提供下列兩個網頁或其中之一,讓使用者完成上述動作:
- 登入網址:使用者可登入現有帳戶。
- 使用者可建立新帳戶的註冊網址。
登入和註冊頁面必須符合下列規定:
- 提供適合行動裝置的使用者體驗。
- 盡量減少註冊程序中的必填欄位。
- 允許使用者在單一頁面中完成登入或註冊。
- 使用
HTTPS加密和有效憑證,確保使用者資料安全傳輸。 - 確保登入網頁和註冊網頁的正常運作時間至少達 99.9%。
除了上述規定外,我們也建議你建立不須填寫任何表單即可註冊會員方案的程序,或是僅在網頁上要求使用者同意服務條款。
- 使用者提供
SharedDataType中的資料後,你就能利用這些資料建立帳戶並立即推送會員卡。 - 你可以隨後再透過電子郵件將動態密碼寄送給使用者,或是提供可讓使用者設定密碼和選填帳戶資訊的連結。
- 這麼做可以降低使用者中途退出註冊程序的可能性,因為每增加一個步驟,都可能會讓使用者萌生放棄的念頭。
顯示登入或註冊網頁時,Google 錢包會建立 Android WebView,並向你提供的網址發出 POST 要求。系統會以 application/x-www-form-urlencoded 的 Content-Type 和 UTF-8 編碼傳送 POST 要求,並透過其中的 SharedDataType 參數提供使用者資料。SharedDataType 參數的值是以 Base64 編碼的 JSON 物件。
JSON 物件可能會包含下列欄位,實際欄位視使用者選擇的動作和你指定使用者填寫的欄位而定。
| 欄位 | 註冊 |
|---|---|
| 電子郵件 | ✓ |
| firstName | ✓ |
| lastName | ✓ |
| addressLine [1-3] | ✓ |
| 城市 | ✓ |
| 州 | ✓ |
| 郵遞區號 | ✓ |
| 國家/地區 | ✓ |
| 手機 | ✓ |
如需 SharedDataType 包含的已解碼 JSON 物件範例,請參閱以下內容。
資源
{
"firstName": "Jane",
"lastName": "Doe",
"addressLine1": "1600 Amphitheatre Pkwy",
"addressLine2": "Apt 123",
"addressLine3": "Attn:Jane",
"city": "Mountain View",
"state": "CA",
"zipcode": "94043",
"country": "US",
"email": "jane.doe@example.com",
"phone": "555-555-5555"
}
步驟 3:建置可立即將會員卡推送回 Google 錢包的機制
完成驗證 (登入) 或建立帳戶 (註冊) 後,你的網頁必須立即將使用者的會員卡推送回 Google 錢包。
你可以重新導向至符合以下結構的連結,將會員卡推送回 Google 錢包。
https://pay.google.com/gp/v/save/{jwt_generated}
網址的長度上限為 2000 個字元,連結數量不應超過這項限制。透過編碼編入 JWT 中的物件應精簡,且僅包含與使用者相關的資料。請試著將大部分資料存放在物件的類別中,並在產生 JWT 前先建立類別。對於超出限制的大型物件,請考慮先透過 Google Wallet API 建立物件,且在 JWT 中只傳送物件 ID。
一般通訊流程
下圖說明使用者完成註冊或登入的通訊流程。你必須負責執行你的伺服器 (下圖中的「Your Server」) 之間的所有動作。

步驟 4:提交驗證與啟用要求
完成開發工作並測試註冊/登入流程後,請提交要求,讓我們審查並全面啟用您的實作項目。
- 前往 Google Pay 和錢包主控台。
- 使用「聯絡支援團隊」小工具。
- 通知支援團隊,你已完成會員註冊整合。
我們會全面審查你建置的項目,在確認相關功能可與 Google 錢包應用程式搭配運作之後,就會公開發布你的會員方案註冊/登入功能。
為確保最佳使用者體驗,我們會定期檢查您的註冊/登入功能,確認持續符合功能規定。如有不一致的情況,系統會通知您,且登入/註冊功能可能會停用,直到問題解決為止。
常見問題
會員方案使用的圖片是否有任何規定? 有。你的圖片託管網址必須採用
HTTPS通訊協定,否則將無法在 Google 錢包中顯示。是否有任何工具可以簡化 JWT 的實作和偵錯? 有。www.jwt.io 等平台可讓你在開發過程中為權杖解碼並進行偵錯,方便你驗證要提交的內容。請注意,Google 與該網站並無任何聯盟關係,也並未特別推薦你採用這類第三方服務。
該如何正確處理採用 Base64 編碼的
SharedDataType資料? 請確認你在開發時全程採用 UTF-8 編碼。JSON 字串會先經過 UTF-8 編碼,再以 android.util.Base64 編碼,並提供 NO_WRAP 和 URL_SAFE 選項。這與 RFC 3548 第 4 節相對應。