前提条件

在使用 Google Wallet API 进行集成之前，请完成以下步骤：

1. 注册 Google Wallet API 发卡机构帐号

您必须拥有发卡机构帐号才能为 Google 钱包创建和分发卡券。注册 Google Pay 和钱包控制台以获取您的发卡机构帐号。注册后，请导航至 Google Wallet API 页面，然后点击构建您的第一张卡券。接受服务条款后，您就可以开始创建卡券类了。

完成上述步骤后，您还可以尝试 Codelab。

2. 启用 Wallet API

3. 创建服务帐号

必须使用服务帐号和服务帐号密钥才能调用 Google Wallet API。服务帐号是调用 Google Wallet API 的身份。服务帐号密钥包含一个私钥，应用可使用该私钥向 Google Wallet API 进行身份验证。

创建服务帐号：

  • 1.在 Google Cloud 控制台中创建服务帐号，提供以下详细信息：
    • 服务帐号名称 - 示例：Wallet Web Client
    • 服务帐号 ID - 示例：my-service-account
  • 2. 点击创建并继续。
  • 3. 点击完成。

创建服务帐号密钥：

  • 1. 选择您的服务帐号。例如：my-service-account@my-project-id.iam.gserviceaccount.com。
  • 2. 点击页面顶部的密钥菜单项。
  • 3. 依次点击添加密钥和创建新密钥。
  • 4. 选择密钥类型 JSON。
  • 5. 点击创建，以创建并下载服务帐号密钥。

4. 为服务帐号授权

您必须对服务帐号授权，才能调用该 API。如需向其授权，请授予服务帐号管理发卡机构帐号的权限。

  • 访问 Google Pay 和钱包控制台中的用户页面。
  • 1. 点击邀请用户。
  • 2. 添加服务帐号的电子邮件地址。例如：my-service-account@my-project-id.iam.gserviceaccount.com。
  • 3. 选择开发者作为访问权限级别。
  • 4. 点击邀请。

5. 创建类

您必须先创建 OfferClass，然后才能创建和添加 OfferObject。为此，请登录 Google Pay 和钱包控制台，导航到 Google Wallet API 页面，然后创建一个新的 Offer 类。

  1. 确保您已打开管理标签页
  2. 如果这是您首次创建卡券，您应该会看到您处于演示模式。
  3. 在演示模式下，点击设置测试帐号即可添加测试帐号。在发卡机构帐号处于演示模式时，只有这些帐号可以保存卡券。
  4. 点击创建课程
  5. 选择优惠
  6. 填写标有 * 的所有必填字段
  7. 点击创建课程

如果您需要多项优惠，请重复本页上的步骤。

请参阅布局模板，详细了解这些属性在卡券中的表示方式。

成功创建 Offer 类后，请继续向 Google 钱包添加卡券。