集成 Apple Pay 支付
通过 Apple Pay 服务,买家可以使用存储在其 Apple Pay 账户中的信用卡或借记卡进行支付。采用 Native API 方式时,商户前端需直接集成 Apple Pay SDK,获取卡资产信息后调用 Antom 的 pay(单笔支付)接口发起支付。有关 Apple Pay SDK 的集成说明,请参见 Apple Pay on the Web 或 Apple Pay (Native)。
注意:采用 Native API 方式集成 Apple Pay 时,您需要有自己的 Apple 商家 ID 和证书,对于 Apple Pay Web 的集成方式,商户需在 Apple 侧完成域名验证。
用户体验
以下图片展示了集成 Apple Pay 进行支付的用户体验:
Web 端
Mobile 端
集成准备
- 已获得 client ID。
- 已完成密钥配置。
- 已完成异步通知接收地址的配置。
- 集成服务端 SDK 资源包,并完成接口库安装及请求示例初始化。具体操作请参阅服务端 SDK。
集成步骤
请按照以下步骤开始集成:
- 解密 ApplePayPaymentToken
- 授权支付
- 获取预授权支付结果
- 请款
步骤 1:解密 ApplePayPaymentToken
当买家在通过 Touch ID、Face ID 或者 passcode 完成 Apple Pay 支付授权后,前端在 Apple Pay 授权事件中获取 ApplePayPaymentToken,详情请参见 或 。在您获取到 ApplePayPaymentToken 以后,您可以选择以下两种方式解密,从而调用 pay(单笔支付)接口来发起授权支付请求:
- 托管解密:由 Antom 负责证书管理和解密操作,您无需具备 PCI 资质。
- 商户解密:您自行管理证书并执行解密操作,您需具备相应的 PCI 资质。
步骤 2:授权支付 服务端
不同的解密方式在发起授权支付请求时所需传入的参数存在差异,请您根据实际采用的解密方式查看对应的内容说明。
托管解密
商户解密
步骤 3:获取授权支付结果 服务端
步骤 4:请款 服务端
支付后操作
完成支付后,您可对交易进行以下支付后的操作:
取消交易 服务端
退款 服务端
争议 服务端
对账 服务端
更多内容
卡支付特性
类型 | 是否支持 | 说明 |
| Antom Tokenization | 条件支持 |
|
| 卡信息存档交易(COF) | 条件支持 | 仅 MIT(商户发起交易)场景支持。 |
| 3D Secure 2 | 支持 | Apple Pay 在完成 3D Secure 2 认证后,会将加密的交易凭证(Cryptogram)和电子商业指示器(ECI)传递至 Antom。Antom 将遵循第三方卡组织的标准流程处理这些认证信息,详情请参阅 Apple Developer: Payment token format reference。因此,Checkout Page 上不会再次出现由支付方式发起的 3DS 认证流程,用户体验无缝衔接。建议您在发起支付请求时,使用 is3DSAuthentication 和 enableAuthenticationUpgrade 参数的默认值。 |
| Antom 3DS-Retry | 支持 | 无。 |
| 商户发起交易(MIT) | 支持 | 无。 |
| 分期付款 | 不支持 | 无。 |



