签发适用于网页、电子邮件和短信的卡券

创建卡券并将其编码到已签名的 JWT 中后，您就可以在“添加到 Google 钱包”链接。为此，您需要向用户显示“添加到 Google 钱包”按钮或超链接，在用户点按卡券后，系统会将卡券保存到他们的 Google 钱包。可使用此方法的位置示例包括网站、电子邮件、短信等。

演示模式 / [仅供测试] 通过

当您仍处于演示模式时，您创建的所有卡券都将有额外的文本“[仅限测试]”标题中。这是为了区分演示卡券与实际卡券。您获得发布权限后，当用户在已连接的设备上重新打开钱包应用时，这些演示模式卡券将不再包含额外文本。

前提条件

在尝试发放卡券之前，请务必执行以下操作：

• 完成新手入门指南中的所有步骤。
• 至少创建一个卡券类。
• 至少创建一个卡券对象。
• 在 JWT 中对卡券类和卡券对象进行编码。
• 使用 Google Cloud 服务账号密钥为 JWT 签名。

1. 创建“添加到 Google 钱包”链接

使用“Google 钱包”签发卡券链接可将卡券对象添加到用户的 Google 钱包中，并且只能在已登录 Google 身份的上下文中启动。

“添加到 Google 钱包”link 是一个动态生成的网址，其中包含经过编码和签名的 JSON 网络令牌 (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 个字符，则保存可能会失败 而将字符串截断。如需了解详情，请参阅此常见问题解答。

如需详细了解如何创建卡券类和卡券对象，请参阅创建卡券类和卡券对象。

如需详细了解如何创建创建“添加到 Google 钱包”所需的已签名 JWT链接，请参阅使用 JSON Web 令牌。

2. （推荐）使用“添加到 Google 钱包”按钮

对于任何支持超链接图片的界面（例如网站和电子邮件），建议显示“添加到 Google 钱包”通过“添加到 Google 电子钱包”向用户提供链接按钮。对于 Google 钱包用户来说，该按钮是一个熟悉的提示，可以识别为向 Google 钱包添加卡券的途径。

• 
• 

图片素材资源可采用多种屏幕方向和语言下载，以支持您的 Google Wallet API 集成。

下载“添加到 Google 电子钱包”按钮