網頁、電子郵件、簡訊的核發票證

建立票證並以已簽署的 JWT 編碼後，只要是支援「新增至 Google 錢包」連結的地方，都可以核發票證。如要這麼做，請向使用者顯示「新增至 Google 錢包」按鈕或超連結，使用者輕觸後，票證就會儲存至 Google 錢包。這類方法可能用於行動應用程式、網站、電子郵件、即時通訊和簡訊等。

「新增至 Google 錢包」連結會在 Google 錢包行動應用程式 (如有安裝) 或 https://wallet.google.com 中開啟。

展示模式 / [僅用於測試] 票證

在展示模式中，您建立的所有票證標題都會加上「[TEST ONLY]」文字。這是為了區分試用票證和正式票證。取得發布權限後，使用者在連結裝置上重新開啟錢包應用程式時，這些展示模式票證就不會再顯示額外文字。

必要條件

嘗試核發票證前，請務必完成下列事項：

• 完成新手上路指南中的所有步驟。
• 建立至少一個票證類別。
• 建立至少一個票證物件。
• 在 JWT 中編碼票證類別和票證物件。
• 使用 Google Cloud 服務帳戶金鑰簽署 JWT。

1. 建立「新增至 Google 錢包」連結

透過「Google 錢包」連結核發票證，會將票證物件新增至使用者的 Google 錢包，且只能在登入 Google 帳戶的情況下啟動。

「新增至 Google 錢包」連結是動態產生的網址，內含經過編碼和簽署的 JSON Web Token (JWT)。

「新增至 Google 錢包」連結的格式如下：

https://pay.google.com/gp/v/save/<signed_jwt>

舉例來說，完整的「新增至 Google 錢包」連結如下所示：

https://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A

這個連結可以嵌入行動應用程式、網站、電子郵件、即時通訊、簡訊，或任何支援超連結的位置。

編碼 JWT 的安全長度為 1800 個字元。如果 JWT 小於這個限制，則整個物件可以包含在已簽署的 JWT 中。如果長度超過 1800 個字元，網路瀏覽器可能會截斷內容，導致無法儲存。詳情請參閱常見問題。

如要進一步瞭解如何建立票證類別和票證物件，請參閱「建立票證類別和票證物件」。

如要進一步瞭解如何建立已簽署的 JWT，以便建立「新增至 Google 錢包」連結，請參閱「使用 JSON Web Token」。

2. (建議) 使用「新增至 Google 錢包」按鈕

對於支援圖片超連結的任何平台 (例如網站和電子郵件)，建議您使用「新增至 Google 錢包」按鈕，向使用者顯示「新增至 Google 錢包」連結。對 Google 錢包使用者來說，這個按鈕是熟悉的提示，可辨識為將票證新增至 Google 錢包的方式。

• 
• 

您可以下載各種方向和語言的圖片素材資源，用於 Google Wallet API 整合。

下載「新增至 Google 錢包」按鈕