「使用 Google 錢包驗證」支援三種整合路徑：兩種線上路徑 (適用於 Android 應用程式和網站)，以及一種親自路徑 (適用於感應式讀卡機和銷售點終端機)。選擇路徑即可開始。
三種整合路徑
信賴方 (RP)
個別商家、企業或應用程式開發人員，直接為自己的網站或 Android 應用程式驗證使用者。
驗證者註冊商 (VR)
IDV 供應商、集結網站或平台，代表多個下游商家 (最終 RP) 驗證使用者。
現場驗證
如果銷售點終端機、場館讀卡機或行動驗證器應用程式支援 ISO/IEC 18013-5 mdoc 擷取功能，則可離線驗證 mDL，不需加入 Google 許可清單 (目前不支援親自出示身分憑證)。
比較線上路徑：依賴方與驗證方註冊商
| 切面 | 信賴方 (RP) | 驗證者註冊商 (VR) |
|---|---|---|
| 誰簽署要求 | Google 簽署憑證 (您提交 CSR) | 您自行執行 CA (沙箱 + 正式環境根 CA)，並為終端 RP 簽署葉憑證 |
| 沙箱憑證 | Google 共用的沙箱測試金鑰和中繼資料 (立即開始測試) | 由您自己的沙箱根 CA 簽署的憑證 (在 Google 信任該 CA 後) |
| 聯絡 Google 的時機 | 最後 (步驟 5)：完成沙箱測試後 | 在開始 (步驟 1) 註冊沙箱和正式環境根 CA |
線上整合指南
選取線上整合路徑，依序完成步驟 1 到 5。 在工程團隊建構步驟 3 的同時，您可以並行完成步驟 1 和 2 (沙箱和測試 ID 設定)。
依賴方 (直接)
設定沙箱
在沙箱中建立測試 ID
使用第二部搭載 Utopia ePassport Simulator 的 Android 裝置，將模擬身分憑證佈建到沙箱裝置上的 Google 錢包。
以依賴方身分整合
請按照「依賴方整合指南」中的四個導入步驟操作：
- 步驟 3.A - 設定要求格式並簽署：建構 OpenID4VP JSON 查詢，並在伺服器上簽署 JWS。
- 步驟 3.B - 觸發 API：呼叫 Android
CredentialManager或 Webnavigator.credentials.get()。 - 步驟 3.C - 解密及驗證回應：解密 JWE，並在伺服器上驗證 IACA 憑證鏈和 MSO。
- 步驟 3.D (選用) - 新增零知識證明：驗證年齡條件，不接收使用者的出生日期。
端對端測試整合項目
請出示 Utopia 測試身分憑證，並對照服務，驗證端對端檢查清單中的每個項目 (包括對照 Utopia 沙箱憑證進行 issuerAuth 驗證)，然後錄製示範影片。
以仰賴方身分上線
提交信賴憑證者新手上路表單，並附上正式環境 CSR、品牌資產和沙箱端對端影片 (正式接受信賴憑證者服務條款)。通過核准後 (通常需要 3 到 5 個工作天)，Google 會傳回已簽署的正式版憑證和專屬 gw_rp_metadata_bytes。
驗證機構註冊商 (集結網站)
提交根 CA 並設定沙箱
首先，請提交驗證者註冊商新手上路資料表，並附上沙箱和正式環境根憑證授權單位憑證 (接受驗證者註冊商服務條款)，讓 Google 信任您的沙箱根憑證授權單位。同時，將測試 Google 帳戶加入許可清單，並將測試 Android 裝置切換至沙箱模式。
在沙箱中建立測試 ID
使用第二部搭載 Utopia ePassport Simulator 的 Android 裝置，將模擬身分憑證佈建到沙箱裝置上的 Google 錢包。
以驗證者註冊商身分整合
請按照驗證者註冊商整合指南中的五個導入步驟操作：
- 步驟 3.A - 設定 CA 和 CBOR 中繼資料：設定 X.509 憑證設定檔 (OID
1.3.6.1.4.1.11129.10.1) 和 CBOR 中繼資料結構定義。 - 步驟 3.B - 設定要求格式並簽署：建構 OpenID4VP JSON 查詢，並使用 End-RP 分葉憑證簽署 JWS。
- 步驟 3.C - 觸發 API：呼叫 Android
CredentialManager或網頁navigator.credentials.get()。 - 步驟 3.D - 解密及驗證回應：解密 JWE，並在伺服器上驗證 IACA 憑證鏈結和 MSO。
- 步驟 3.E (選用) - 新增零知識證明：驗證年齡條件，不接收使用者的出生日期。
端對端測試整合項目
Google 通知您 Sandbox 根憑證授權單位已受信任後，請簽署測試 End-RP 憑證、信任伺服器上的 Utopia Sandbox 憑證、使用 Utopia 測試身分憑證進行測試，並錄製驗證者託管和商家託管流程的示範影片。
以驗證者註冊商身分上線，並引導終端 RP
提交 E2E 影片供審查。Google 會核准影片，並同時信任正式環境根 CA。接著，使用驗證者註冊商用戶端新手上路表單註冊每個下游用戶端，並核發具有全球不重複辨別名稱的分葉憑證。
事前準備
- 伺服器：建立要求並驗證回應。在伺服器上產生完整要求，即使是 Android 應用程式也一樣。
- 兩部 Android 裝置：一部用於執行電子護照模擬器，另一部用於在 Google 錢包中存放測試身分證件。請使用專用測試裝置，因為切換至沙箱會刪除裝置的正式版錢包資料。
- 測試時，請使用 @gmail.com Google 帳戶登入 Google 錢包。
- 同意畫面的顯示素材資源：顯示名稱、標誌 (請參閱品牌宣傳指南)、隱私權政策網址和《服務條款》網址。