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 进行支付的用户体验：
Web
WAP

集成准备

  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. 发起请款

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

用户体验

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

集成准备

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

集成步骤

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

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

支付后操作

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

取消交易
服务端

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

退款
服务端

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

争议
服务端

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

更多内容

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

最佳实践

卡支付特性同样适用于 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）
支持
无。
分期付款
不支持
无。