集成 Google Pay 订阅支付
订阅支付是一种周期性自动扣款解决方案，可以帮助您完成周期性自动收款。仅需一次授权即可绑定支付账户享受持续的订阅服务，且支持动态调整订阅配置（如修改周期/金额、取消续订或终止服务等）。整个流程既便捷高效，又安全可靠。
通过 Google Pay 服务，买家可以使用存储在其 Google 账户中的信用卡或借记卡进行支付。借助 Antom Payment Element，您无需额外集成 Google Pay 的 SDK，Payment Element 将自动为您加载 Google Pay 服务，并可将 Google Pay 配置为极速支付方式。
Web/WAP
用户体验
以下图片展示了使用 Google Pay 进行支付的用户体验：
集成准备
- 在使用 Payment Element 前，需完成 Google Pay 商家控制台的入驻与发布流程：
- 注册账户并根据页面指引填写您的业务信息，页面右上角为您的 Google Pay ID：
- 根据页面指引完成 Google Pay 的配置：
- 配置域名白名单：为确保支付安全，必须授权您的业务域名。在控制台中进入 Business Profile > Google Pay API，在 Integrate with your website 部分，点击 + Add website 添加您网站的所有正式域名。
注意：Web Element 基于 Google Pay 接口的 JavaScript 库实现，无法在移动应用的 WebView 中直接使用，页面必须通过手机浏览器打开。
- 已获得 client ID。
- 已完成密钥配置。
- 已完成异步通知接收地址的配置。
- 集成 Antom 服务端 SDK 资源包，并完成接口库安装及请求示例初始化。具体操作请参阅服务端 SDK。
- 参阅 Web/WAP 端集成 SDK 资源包文档来集成客户端 SDK 资源包，并注意使用最新或不低于 1.46.0 版本的 SDK。
集成步骤
按照以下步骤开始集成：
- 创建支付会话
- 调用 Payment Element
- 获取授权结果
- 请款
- 获取订阅通知
步骤 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：获取授权结果 服务端
步骤 4：请款 服务端
步骤 5：获取订阅通知 服务端
Android
用户体验
以下图片展示了使用 Google Pay 进行支付的用户体验：
集成准备
- 在使用 Payment Element 前，需完成 Google Pay 商家控制台的入驻与发布流程：
- 注册账户并根据页面指引填写您的业务信息，页面右上角为您的 Google Pay ID：
- 根据页面指引完成 Google Pay 的配置：
- 根据 Google Pay 的要求将应用发布至 Google Play。
- 已获得 client ID。
- 已完成密钥配置。
- 已完成异步通知接收地址的配置。
- 集成 Antom 服务端 SDK 资源包，并完成接口库安装及请求示例初始化。具体操作请参阅服务端 SDK。
- 参阅 Android 端集成 SDK 资源包文档来集成客户端 SDK 资源包，并注意使用最新或不低于 1.46.0 版本的 SDK，同时目标运行环境须为 API 级别 24 及更高版本。
- 集成 Antom Google Pay 插件：
- 使用以下代码在 build.gradle 文件中添加 Maven 依赖：
dependencies {
implementation 'com.alipay.antom.sdk:plugin-googlepay:1.0.0'
}- （可选）如果您的项目尚未集成 Google Pay 官方 SDK，请额外添加以下依赖：
dependencies {
// 18.1.3 为示例版本号，请根据您的实际需求选择合适的版本
implementation 'com.google.android.gms:play-services-wallet:18.1.3'
}集成步骤
请按照以下步骤开始集成：
- （可选）预加载 SDK
- 创建支付会话
- 调用 Payment Element
- 获取授权结果
- 请款
- 获取订阅通知
（可选）步骤 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 的极速支付形式。有效值为：
注意：该参数目前仅支持在 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：获取授权结果 服务端
步骤 5：请款 服务端
步骤 6：获取订阅通知 服务端
订阅后操作
完成订阅后，您可以进行以下操作：
查询订阅相关信息 服务端
订阅确认后，您可以查询以下订阅信息：
- 查询订阅列表：您可以通过 inquireSubscriptionList 接口查询符合特定筛选条件的订阅列表。
- 查询订阅详情：您可以使用 subscriptionId 调用 inquireSubscription 接口来获取订阅详情。
- 查询订阅交易信息：您可以使用 subscriptionId 调用 inquireSubscriptionPayment 接口来获取订阅交易的列表信息。
订阅试用 服务端
终止订阅 服务端
取消交易 服务端
退款 服务端
对于已支付成功的订单，如您需向买家发起退款，Antom 提供以下两种方式：
- 由您的运营人员直接在 Antom Dashboard 平台上进行人工退款。
- 通过调用 refund 接口发起退款。
Antom 的退款能力如下：
- 支持全额退款。
- 支持部分多次退款，多次退款的总金额需小于等于请款金额。
争议 服务端
对账 服务端
更多内容
Antom 还为您提供以下定制化内容：
- 自定义外观样式：Antom 提供了丰富的样式自定义能力，包含主题、布局以及 CSS 样式自定义功能。
最佳实践
卡支付特性同样适用于 Google Pay，以下列举了卡支付特性对于 Google Pay 的支持情况：
类型 | 是否支持 | 支持说明 |
| Antom Tokenization | 条件支持 |
|
| 卡信息存档交易（COF） | 支持 | 无。 |
| 3D Secure 2 | 支持 |
|
| Antom 3DS-Retry | 支持 | 无。 |
| 商户发起交易（MIT） | 支持 | 无。 |
| 分期付款 | 不支持 | 无。 |