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

集成 Apple Pay 订阅支付

订阅支付是一种周期性自动扣款解决方案，可以帮助您完成周期性自动收款。仅需一次授权即可绑定支付账户享受持续的订阅服务，且支持动态调整订阅配置（如修改周期/金额、取消续订或终止服务等）。整个流程既便捷高效，又安全可靠。
通过 Apple Pay 服务，买家可以使用存储在其 Apple 账户中的信用卡或借记卡进行支付。借助 Antom Payment Element，您无需额外集成 Apple Pay 的 SDK，Payment Element 将自动为您加载 Apple Pay 服务，并可将 Apple Pay 配置为极速支付方式。
Web/WAP

用户体验

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

集成准备

  1. Antom 为您提供预置的 Apple Pay 商户认证，方便您快速集成。详细步骤请参考 Apple Pay 域名配置。
  1. 在您开始集成前，请阅读集成指南及接口概述文档，了解服务端接口的集成步骤及调用接口的注意事项，并确保已完成以下预配置：
    • 已获得 client ID。
    • 已完成密钥配置。
    • 已完成异步通知接收地址的配置。
    • 集成 Antom 服务端 SDK 资源包，并完成接口库安装及请求示例初始化。具体操作请参阅服务端 SDK。
    • 参阅 Web/WAP 端集成 SDK 资源包文档来集成客户端 SDK 资源包，并注意使用最新或不低于 1.46.0 版本的 SDK。

集成步骤

按照以下步骤开始集成：
  1. 创建支付会话
  2. 调用 Payment Element
  3. 获取授权结果
  4. 请款
  5. 获取订阅通知

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

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

步骤 2：调用 Payment Element
客户端

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

步骤 3：获取授权结果
服务端

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

步骤 4：请款
服务端

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

步骤 5：获取订阅通知
服务端

订阅关系生效后，Antom 会为您发送首期订阅通知及订阅续期通知，请参阅步骤 5：获取订阅通知获取相关通知。
iOS

用户体验

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

集成准备

在您开始集成前，请阅读集成指南及接口概述文档，了解服务端接口的集成步骤及调用接口的注意事项，并确保已完成以下预配置：
  • 已获得 client ID。
  • 已完成密钥配置。
  • 已完成异步通知接收地址的配置。
  • 集成 Antom 服务端 SDK 资源包，并完成接口库安装及请求示例初始化。具体操作请参阅服务端 SDK。
  • 参阅 iOS 端集成 SDK 资源包文档来集成客户端 SDK 资源包，并注意使用最新或不低于 1.46.0 版本的 SDK。

集成步骤

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

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

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

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

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

步骤 3：调用 Payment Element
客户端

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

步骤 4：获取授权结果
服务端

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

步骤 5：请款
服务端

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

步骤 6：获取订阅通知
服务端

订阅关系生效后，Antom 会为您发送首期订阅通知及订阅续期通知，请参阅步骤 6：获取订阅通知获取相关通知。

订阅后操作

完成订阅后，您可以进行以下操作：

查询订阅相关信息
服务端

订阅确认后，您可以查询以下订阅信息：

订阅试用
服务端

Antom 提供订阅试用功能，帮助买家在正式购买订阅计划前，以免费或优惠价格在限定时间内体验产品或服务。详情请参阅订阅试用文档。

终止订阅
服务端

终止订阅功能允许买家在不需要继续使用相关服务时，随时取消当前订阅。详情请参阅终止订阅文档。

取消交易
服务端

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

退款
服务端

对于已支付成功的订单，如您需向买家发起退款，Antom 提供以下两种方式：
  • 由您的运营人员直接在 Antom Dashboard 平台上进行人工退款。
  • 通过调用 refund 接口发起退款。
Antom 的退款能力如下：
  • 支持全额退款。
  • 支持部分多次退款，多次退款的总金额需小于等于请款金额。
具体的集成方案请参阅退款。

争议
服务端

若买家选择使用卡支付，可能涉及争议相关问题，更多信息请参阅争议运营手册。

对账
服务端

交易完成后，使用 Antom 提供的财务报告进行对账。有关如何对账和 Antom 结算规则的更多信息，请参阅对账。

更多内容

Antom 还为您提供以下定制化内容：
  • 指定支付方式：您可以通过接口参数指定在 Payment Element 上展示的支付方式、支付方式列表的排序，以及极速支付方式的展示。
  • 支付方式特性：了解 APM 及卡支付的相关特性。
  • 自定义外观样式：Antom 提供了丰富的样式自定义能力，包含主题、布局以及 CSS 样式自定义功能。

最佳实践

卡支付特性同样适用于 Apple Pay，以下列举了卡支付特性对于 Apple Pay 的支持情况：
类型
是否支持
支持说明
Antom Tokenization
条件支持
  • CIT（持卡人发起交易）场景不支持，建议您通过 Apple 账户存卡。
  • MIT（商户发起交易）场景支持。
卡信息存档交易（COF）
条件支持
仅 MIT（商户发起交易）场景支持。
3D Secure 2
支持
Apple Pay 在完成 3D Secure 2 认证后，会将加密的交易凭证（Cryptogram）和电子商业指示器（ECI）传递至 Antom。Antom 将遵循第三方卡组织的标准流程处理这些认证信息，详情请参阅 Apple Developer: Payment token format reference。因此，Payment Element 上不会再次出现由支付方式发起的 3DS 认证流程，用户体验无缝衔接。建议您在发起支付请求时，使用 is3DSAuthentication 和 enableAuthenticationUpgrade 参数的默认值。
Antom 3DS-Retry
支持
无。
商户发起交易（MIT）
支持
无。
分期付款
不支持
无。