前提条件

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

1. 注册 Google Wallet API Issuer 帐号

必须使用发卡机构帐号才能创建和分发 Google 电子钱包卡券。通过注册 Google Pay 和电子钱包控制台来获取您的发卡机构帐号。填写完商家资料后,请转至 Google Wallet API 页面并点击申请访问权限。在说明中指明您将使用 Android SDK,完成核对清单,最后提交请求。

在等待您的卡券访问权限获得批准时,您可以创建临时开发者帐号或试用 Codelab

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

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

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

要在 Android 应用中成功使用 Android 版 Google Wallet API,您需要对您的应用授权。您可以使用开发者密钥中的 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:16.0.1'
}

5. 创建卡券类

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

  1. 确保您当前位于管理标签页中
  2. 点击创建课程
  3. 选择礼品卡
  4. 填写所有标有 * 的必填字段
  5. 点击创建课程

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

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