使用者會員方案註冊資料

會員註冊與登入功能可讓使用者搜尋 ，然後從 Google 錢包加入或登入自己的帳戶。 系統會將使用者導向至行動裝置適用的網站，以便完成 程序完成後，即可將卡片新增至 Google 錢包。

本指南將概略說明必要的實作步驟 啟用會員方案的會員方案

總覽

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

如要實作註冊與登入功能，請按照下列四個步驟操作 專屬優惠

1. 在 Google 錢包中設定測試類別，以測試註冊/登入流程。
2. 開發使用 Google 電子錢包 SharedDataType 的註冊/登入網頁。
3. 建置可在使用者註冊/登入後將會員卡推送回 Google 錢包的機制。
4. 要求驗證及啟用。

在 Google 錢包中設定測試類別

請確認註冊和登入網址、會員方案標誌和指定的使用者欄位，接著： 請使用 discoverableProgram 巢狀欄位的 loyaltyclass 能設定 適當的值。

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

在開發期間完成導入功能驗證 程序，請使用 Google Pay 和錢包主控台中的「聯絡支援」小工具與我們聯絡。在 控制台，選取主題中的「Google Wallet API」，然後選取「會員方案登入/註冊」 次主題。

開發使用 Google 錢包使用者資料的註冊和登入網頁

使用者選擇登入或註冊你的會員方案時， 將使用者帶往你網站上的專屬網頁，以便完成 註冊或登入程序。如果使用者選擇註冊，Google 錢包 會要求使用者核准與您分享使用者資料。

您必須提供下列兩個網頁或其中之一，讓使用者完成相關動作。

1. 可讓使用者登入現有帳戶的登入網址。
2. 可讓使用者建立新帳戶的註冊網址。

登入和註冊網頁必須符合下列規定：

• 提供適合行動裝置的使用者體驗。
• 盡量減少註冊過程中的必填欄位。
• 讓使用者在單一頁面中完成登入或註冊程序。
• 使用有效憑證並採用「HTTPS」加密，確保使用者資料安全無虞 安全傳輸
• 確保登入網頁和註冊網頁的運作時間至少為 99.9%。

除了上述規定外，我們也建議允許使用者 不必填寫任何表單就能註冊會員方案 讓網頁僅保留接受服務條款。

• 只要利用 SharedDataType 中提供的使用者資料，即可建立帳戶 並立即推送會員卡
• 之後您可以透過電子郵件將動態密碼或連結傳送給使用者 以設定密碼和選填的帳戶詳細資料。
• 這樣可以降低使用者放棄註冊程序的可能性。 因為每多一個步驟就可能會讓使用者流失

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

注意：JSON 字串開頭採用 UTF-8 編碼，隨後則 使用 編碼 android.util.Base64 以及 NO_WRAP 和 URL_SAFE 選項。這與 RFC 3548 第 4 節。

視使用者選擇的動作和你指定的欄位而定 要求使用者要求，JSON 物件可能包含下列欄位。

欄位	註冊
電子郵件	✓
firstName	✓
lastName	✓
地址行 [1-3]	✓
city	✓
州	✓
郵遞區號	✓
country	✓
手機	✓

注意：以上皆非 保證能刊登內容，而且您的網站必須允許使用者 。

注意：如果您要求使用者提供欄位， 確認這些詳細資料會用於預先填入表單。

請參閱下方已解碼的 JSON 物件範例 包含在 SharedDataType 中。

資源

{
  "firstName": "Jane",
  "lastName": "Doe",
  "addressLine1": "1600 Amphitheatre Pkwy",
  "addressLine2": "Apt 123",
  "addressLine3": "Attn:Jane",
  "city": "Mountain View",
  "state": "CA",
  "zipcode": "94043",
  "country": "US",
  "email": "[e-mail]",
  "phone": "555-555-5555"
}

實作可立即將會員卡推送回 Google 錢包的功能

完成驗證 (登入) 或建立帳戶 (註冊) 後，您的網頁 應立即將使用者的會員卡推送回 Google 錢包。

注意：請勿提供 Google Wallet API 按鈕 因為使用者應在不需任何額外互動的情況下返回 Google 錢包。

您可以將會員卡重新導向至 Google 錢包， 連結會遵循以下結構

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

敬上

注意：請務必 以「/」結尾。

注意：JWT 未加密。只能包含 無法以純文字格式分享深層連結的資料。

網址的長度上限為 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 節。