银行卡支付

本文针对卡支付方式的集成流程进行详细说明。

集成前提

在正式开始集成之前，您需要完成以下准备工作：
欲知更多详情，请参考集成指南。

支付流

所有通过卡支付方式进行的收单交易均为授权请款模式，即分为授权（Authorization）和请款（Capture）两步。买家在结账时先授权付款，授权阶段会锁定特定金额的付款资金，仅在请款成功后才将资金转移到您的账户。默认情况下，APO 会为您自动发起并完成请款，但您也可以选择自行调用 capture 接口发起并完成请款。
卡支付的整体流程如下图所示：
图 1. 授权支付与请款流程
图 2. 取消授权支付流程
注意：收单机构的路由分为智能和自定义两种情况：
  • 智能路由：APO 为您默认启用智能路由来优先保证支付成功率，基于大数据和 AI 算法为每笔交易智能决策最优收单机构以实现更高支付成功率。您也可以选择关闭智能路由能力。
  • 自定义路由：您可以在 APO 中自定义路由规则，符合规则的交易会按照规则路由到目标收单机构。自定义路由的优先级高于智能路由，在您未关闭智能路由的前提下，不符合自定义路由规则的交易会由智能路由帮助您决策最佳收单机构。
关于如何自定义路由规则，您可以联系 Antom 技术支持。

集成步骤

支付场景的集成步骤如下：
  1. （可选）独立绑卡。
  2. 展示支付方式。
  3. 发起授权支付，并展示支付结果。
  4. （可选）取消授权支付。
  5. 发起请款。
注意：在授权支付阶段，可以通过 API 或 SDK 进行集成。

步骤 2：展示支付方式

联系您的技术支持获取可用支付方式。呈现支付方式时，建议您按照如下方式进行：
表 1. 支付方式不同呈现方式及用户体验

步骤 3：授权支付

发起授权支付的过程，可以通过 API 或 SDK 两种方式进行集成：
表 2. 授权支付的不同集成方式说明
如果您未使用独立绑卡能力，您也可以在授权支付阶段为买家提供独立绑卡能力。
  • 关于如何使用 SDK 进行集成，详情参见 SDK 集成。
  • 关于如何调用 API 进行集成，详情参见 API 集成。

步骤 5：发起请款

您可以选择以下请款方式中的其中一种：
  • 自动请款：买家授权完成后 APO 会自动立即发起请款。请款成功后，APO 会向您发送请款结果通知。请款模式在如下情况下均为自动请款：
  • 手动请款：买家授权完成后，您需要自己通过 capture 接口发起请款请求。需注意的是，请款的总金额需等于买家授权的金额。您需指定 pay 或 createPaymentSession 接口的 paymentFactor.captureMode 字段值为
    MANUAL
    。
注意：卡支付场景下，建议您以请款成功作为发货依据。
关于如何发起请款等更多请款相关内容，请参考请款。
​