前提条件

在开始与 Google Wallet API 集成之前,请完成以下步骤:

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

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

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

2. 熟悉 Android 平台上的应用开发

在本教程中,您将熟悉 Android 平台应用开发的基本概念和技能。如果您需要先了解 Android 开发,请参阅 Android 开发者培训的一些课程。

3. 获取凭据以向您的应用授权

如需在 Android 应用中成功使用 Google Wallet API for Android,您需要对您的应用授权。您可以使用开发者密钥中的 SHA1 指纹和软件包名称执行此操作。

若要让您的应用获得批准,您需要获取证书的 SHA1 指纹。如需查找指纹,请打开终端窗口并运行 Keytool 实用程序

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

调试密钥库通常位于 ~/.android/debug.keystore,其密码为 android

Keytool 将指纹输出到 shell 程序中。例如:

$ keytool -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v
Enter keystore password: Type "android" if using debug.keystore
Alias name: androiddebugkey
Creation date: Aug 27, 2012
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 503bd581
Valid from: Mon Aug 27 13:16:01 PDT 2012 until: Wed Aug 20 13:16:01 PDT 2042
Certificate fingerprints:
   MD5:  1B:2B:2D:37:E1:CE:06:8B:A0:F0:73:05:3C:A3:63:DD
   SHA1: D8:AA:43:97:59:EE:C5:95:26:6A:07:EE:1C:37:8E:F4:F0:C8:05:C8
   SHA256: F3:6F:98:51:9A:DF:C3:15:4E:48:4B:0F:91:E3:3C:6A:A0:97:DC:0A:3F:B2:D2:E1:FE:23:57:F5:EB:AC:13:30
   Signature algorithm name: SHA1withRSA
   Version: 3

复制在上述示例中突出显示的 SHA1 指纹。在向应用授权时,需要提供应用的指纹和软件包名称。您可以通过商家控制台联系人支持微件与支持团队联系来授权应用。

4. 设置 Google Play 服务

如果您还没有 Android Studio,请下载并安装 Android Studio

Android 版 Google 钱包是 Google Play 服务的一部分。如需导入 Google Play 服务库,请按照说明设置 Google Play 服务

尤其是要导入 Android 版 Google Wallet API,请将以下代码添加到应用模块中的 build.gradle 文件的依赖项块中:

dependencies {
  implementation 'com.google.android.gms:play-services-pay:16.0.3'
}

5. 创建卡券类

您必须先创建 GiftCardClass,然后才能创建和添加礼品卡。为此,请登录 Google Pay 和钱包控制台,然后转到 Google Wallet API 页面并创建新的 GiftCardClass

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

如果您需要多张礼品卡,请重复执行上述步骤。

现在,您已成功创建 GiftCardClass,接下来可向 Google 钱包添加卡券