Antom, leading provider of tailored payment solutions
Contact Us
Log In

集成 Google Pay 支付

通过 Google Pay 服务，买家可以使用存储在其 Google 账户中的信用卡或借记卡进行支付。借助 Antom Payment Element，您无需额外集成 Google Pay 的 SDK，Payment Element 将自动为您加载 Google Pay 服务，并可将 Google Pay 配置为极速支付方式。
Web/WAP

用户体验

以下图片展示了使用 Google Pay 进行支付的用户体验：
Web
WAP

集成准备

  1. 在使用 Payment Element 前，需完成 Google Pay 商家控制台的入驻与发布流程：
    1. 注册账户并根据页面指引填写您的业务信息，页面右上角为您的 Google Pay ID：
    2. 根据页面指引完成 Google Pay 的配置：
    3. 配置域名白名单：为确保支付安全，必须授权您的业务域名。在控制台中进入 Business Profile > Google Pay API，在 Integrate with your website 部分，点击 + Add website 添加您网站的所有正式域名。
注意：Web Element 基于 Google Pay 接口的 JavaScript 库实现，无法在移动应用的 WebView 中直接使用，页面必须通过手机浏览器打开。
  1. 在您开始集成前，请阅读集成指南及接口概述文档，了解服务端接口的集成步骤及调用接口的注意事项，并确保已完成以下预配置：
    • 已获得 client ID。
    • 已完成密钥配置。
    • 已完成异步通知接收地址的配置。
    • 集成 Antom 服务端 SDK 资源包，并完成接口库安装及请求示例初始化。具体操作请参阅服务端 SDK。
    • 参阅 Web/WAP 端集成 SDK 资源包文档来集成客户端 SDK 资源包，并注意使用最新或不低于 1.46.0 版本的 SDK。

集成步骤

按照以下步骤开始集成：
  1. 创建支付会话
  2. 调用 Payment Element
  3. 获取支付结果
  4. 发起请款

步骤 1：创建支付会话
服务端

传入订单信息以调用 createPaymentSession（单笔支付）接口来创建支付会话，获取唤起 Payment Element 的 paymentSessionData。您可选择由您自行渲染收银台的 Google Pay 或由 Payment Element 为您渲染支付方式列表。
自行渲染 Google Pay
如果您自行渲染 Google Pay，建议在买家选择支付方式并提交支付后调用 createPaymentSession（单笔支付）接口。按照步骤 1：创建支付会话的操作创建支付会话，您必须传入参数列表中的所有参数，同时，还需传入以下参数：
参数名称
是否必需
描述
availablePaymentMethod.paymentMethodMetaData.googlePayConfiguration.configuration.merchantId
是
传入您在 Google 侧注册并激活的 Google Pay ID。
availablePaymentMethod.paymentMethodTypeList.paymentMethodType
否
指定具体的支付方式：
由 Payment Element 渲染支付方式列表
如果由 Payment Element 为您渲染支付方式列表，建议您在加载收银台页面时调用 createPaymentSession（单笔支付）接口。按照步骤 1：创建支付会话的操作创建支付会话，您需传入参数列表中列出的基础参数。同时，还需传入以下参数：
参数名称
是否必需
描述
availablePaymentMethod.paymentMethodMetaData.googlePayConfiguration.configuration.merchantId
是
传入您在 Google 侧注册并激活的 Google Pay ID。

步骤 2：调用 Payment Element
客户端

按照步骤 2：调用 Payment Element 的操作在您的客户端使用 paymentSessionData 调用 Payment Element，买家提交支付后，Payment Element 会根据不同支付方式，负责展示二维码、跳转支付方式页面、3DS 认证、回跳商户结果页等流程。

步骤 3：获取支付结果
服务端

在买家完成支付或支付超时后，您可以接收来自 Antom 的异步通知或通过主动查询来获取支付结果，具体步骤请参阅获取支付结果。

步骤 4：请款
服务端

Antom 提供自动请款和手动请款两种请款方式，您可根据业务需求自行选择。请款后，您可以通过异步通知或主动查询来获取请款结果，您需要根据请款结果来决定是否发货。具体操作请参阅请款。
Android

用户体验

以下图片展示了使用 Google Pay 进行支付的用户体验：

集成准备

  1. 在使用 Payment Element 前，需完成 Google Pay 商家控制台的入驻与发布流程：
    1. 注册账户并根据页面指引填写您的业务信息，页面右上角为您的 Google Pay ID：
    2. 根据页面指引完成 Google Pay 的配置：
    3. 根据 Google Pay 的要求将应用发布至 Google Play。
  1. 在您开始集成前，请阅读集成指南及接口概述文档，了解服务端接口的集成步骤及调用接口的注意事项，并确保已完成以下预配置：
    • 已获得 client ID。
    • 已完成密钥配置。
    • 已完成异步通知接收地址的配置。
    • 集成 Antom 服务端 SDK 资源包，并完成接口库安装及请求示例初始化。具体操作请参阅服务端 SDK。
    • 参阅 Android 端集成 SDK 资源包文档来集成客户端 SDK 资源包，并注意使用最新或不低于 1.46.0 版本的 SDK，同时目标运行环境须为 API 级别 24 及更高版本。
    • 集成 Antom Google Pay 插件：
      • Maven 集成：使用以下代码在 build.gradle 文件中添加依赖：
dependencies {
    implementation 'com.alipay.antom.sdk:plugin-googlepay:${antom_version}'
}
      • 手动集成：请联系 Antom 技术支持获取 Google Pay 的 .aar 文件。完成 Google Pay 插件添加后，还需在 build.gradle 文件中引入 Google 官方 SDK，以确保相关资源正确引用。详见手动集成。
dependencies {
  // 18.1.3 为 Antom Google Pay 插件所依赖的版本号，最新版本可参考 Play Services Wallet 的 Maven 仓库：https://mvnrepository.com/artifact/com.google.android.gms/play-services-wallet
  implementation 'com.google.android.gms:play-services-wallet:18.1.3'
}

集成步骤

请按照以下步骤开始集成：
  1. （可选）预加载 SDK
  2. 创建支付会话
  3. 调用 Payment Element
  4. 获取支付结果
  5. 发起请款

（可选）步骤 1：预加载 SDK
客户端

在创建支付会话前，强烈建议您预加载 SDK，以提升收银台页面的渲染速度，减少买家在支付过程中的等待时间。按照以下代码示例执行预加载操作：
AMSPaymentElement.preload(getApplicationContext());

步骤 2：创建支付会话
服务端

传入订单信息以调用 createPaymentSession（单笔支付）接口来创建支付会话，获取唤起 Payment Element 的 paymentSessionData。您可选择由您自行渲染收银台的 Google Pay 或由 Payment Element 为您渲染支付方式列表。
自行渲染 Google Pay
如果您自行渲染 Google Pay，建议在买家选择支付方式并提交支付后调用 createPaymentSession（单笔支付）接口。按照步骤 2：创建支付会话的方法创建支付会话，您必须传入参数列表中的所有参数，同时，还需传入以下参数：
参数名称
是否必需
描述
availablePaymentMethod.paymentMethodMetaData.googlePayConfiguration.configuration.merchantId
是
传入您在 Google 侧注册并激活的 Google Pay ID。
availablePaymentMethod.paymentMethodTypeList.paymentMethodType
否
指定具体的支付方式：
availablePaymentMethod.paymentMethodTypeList.expressCheckout
否
设置是否使用 Google Pay 的极速支付形式。有效值为：
  • true：表示设置 Google Pay 为极速支付形式。
  • false：表示 Google Pay 为普通支付形式。默认值。
注意：该参数目前仅支持在 Android 端使用。
由 Payment Element 渲染支付方式列表
如果由 Payment Element 为您渲染支付方式列表，建议您在加载收银台页面时调用 createPaymentSession（单笔支付）接口。按照步骤 2：创建支付会话的操作创建支付会话，您需传入参数列表中列出的基础参数。同时，还需传入以下参数：
参数名称
是否必需
描述
availablePaymentMethod.paymentMethodMetaData.googlePayConfiguration.configuration.merchantId
是
传入您在 Google 侧注册并激活的 Google Pay ID。

步骤 3：调用 Payment Element
客户端

按照步骤 3：调用 Payment Element 的操作在您的客户端使用 paymentSessionData 调用 Payment Element，买家提交支付后，Payment Element 会根据不同支付方式，负责展示二维码、跳转支付方式页面、3DS 认证、回跳商户结果页等流程。

步骤 4：获取支付结果
服务端

在买家完成支付或支付超时后，您可以接收来自 Antom 的异步通知或通过主动查询来获取支付结果，具体步骤请参阅获取支付结果。

步骤 5：请款
服务端

Antom 提供自动请款和手动请款两种请款方式，您可根据业务需求自行选择。请款后，您可以通过异步通知或主动查询来获取请款结果，您需要根据请款结果来决定是否发货。具体操作请参阅请款。

支付后操作

完成支付后，您可对交易进行以下支付后的操作：

取消交易
服务端

对于支付成功的订单，如果买家在当天内申请取消订单或退款，您可以通过 Antom 提供的取消支付能力将订单取消或解冻资金。此外，对于尚未完成支付的订单，您也可以直接进行取消。具体操作请参阅取消交易。

退款
服务端

不同支付方式的退款能力各有差异，若您需要了解 Antom 的退款规则及如何对成功的交易发起退款，请参阅退款。

争议
服务端

当某笔交易发生争议时，Antom 为您提供争议处理相关服务。更多信息请参阅争议运营手册和争议实施方案。

更多内容

Antom 还为您提供以下定制化内容：
  • 指定支付方式：您可以通过接口参数指定在 Payment Element 上展示的支付方式、支付方式列表的排序，以及极速支付方式的展示。
  • 支付方式特性：了解 APM 及卡支付的相关特性。

最佳实践

卡支付特性同样适用于 Google Pay，以下列举了卡支付特性对于 Google Pay 的支持情况：
类型
是否支持
支持说明
Antom Tokenization
条件支持
  • CIT（持卡人发起交易）场景不支持，建议您通过 Google 账户存卡。
  • MIT（商户发起交易）场景支持。
卡信息存档交易（COF）
支持
无。
3D Secure 2
支持
  • 您将 paymentMethodMetaData.googlePayConfiguration.allowedAuthMethods 参数设为 CRYPTOGRAM_3DS 或使用了默认值，并且 Google Pay 侧已经完成 3DS 验证，Antom 按第三方机构 3DS 处理流程，Payment Element 不会出现支付方式侧 3DS 的体验，详情请参阅 Google Pay - 为全球符合条件的 Visa 设备令牌交易启用责任转移。
  • 您将 paymentMethodMetaData.googlePayConfiguration.allowedAuthMethods 参数设为 CRYPTOGRAM_3DS 和 PAN_ONLY 或使用默认值，如 Google Pay 侧未完成 3DS 验证，Payment Element 会根据您传入的 is3DSAuthentication 和 enableAuthenticationUpgrade 决策是否需要 3DS 验证。
Antom 3DS-Retry
支持
无。
商户发起交易（MIT）
支持
无。
分期付款
不支持
无。