卡支付
本文针对卡支付方式的集成流程进行详细说明。
集成前提
在正式开始集成之前,您需要完成以下准备工作:
- 注册 Antom Dashboard 账号。
- 设置您的密钥。
欲知更多详情,请参考集成指南。
支付流
所有通过卡支付方式进行的收单交易均为授权请款模式,即分为授权(Authorization)和请款(Capture)两步。买家在结账时先授权付款,授权阶段会锁定特定金额的付款资金,仅在请款成功后才将资金转移到您的账户。默认情况下,APO 会为您自动发起并完成请款,但您也可以选择自行调用 请款 接口发起并完成请款。
卡支付的整体流程如下图所示:
图 1. 授权支付与请款流程
图 2. 取消授权支付流程
注意:收单机构的路由分为智能和自定义两种情况:
- 智能路由:APO 为您默认启用智能路由来优先保证支付成功率,基于大数据和 AI 算法为每笔交易智能决策最优收单机构以实现更高支付成功率。您也可以选择关闭智能路由能力。
- 自定义路由:您可以在 APO 中自定义路由规则,符合规则的交易会按照规则路由到目标收单机构。自定义路由的优先级高于智能路由,在您未关闭智能路由的前提下,不符合自定义路由规则的交易会由智能路由帮助您决策最佳收单机构。
关于如何自定义路由规则,您可以联系 Antom 技术支持。
集成步骤
支付场景的集成步骤如下:
- (可选)独立绑卡。
- 展示支付方式。
- 发起授权支付,并展示支付结果。
- (可选)取消授权支付。
- 发起请款。
注意:在授权支付阶段,可以通过 API 方式或 SDK 方式进行集成。
步骤 1:(可选)独立绑卡
您可以通过 APO 接入独立绑定银行卡的能力,这样您的买家可以随时随地在您的平台中选择添加银行卡,包括但不限定在购物付款前进行绑卡,或购物时选择完卡支付方式后添加银行卡,方便后续购物时快速付款。银行卡绑定后,APO 会返回给您对应的卡令牌 (cardToken),后续的支付您通过传入卡令牌完成即可,无需买家再重复输入卡信息。如果您未选择使用独立绑卡能力,您也可以在授权支付过程中为买家提供绑卡能力。
关于更多如何实现独立绑卡能力相关内容,请参考独立绑卡。
步骤 2:展示支付方式
联系您的技术支持获取可用支付方式。呈现支付方式时,建议您按照如下方式进行:
呈现支付方式的方式 | 用户体验 |
用户首次支付,您可以将卡品牌标识(logo)和对应的卡品牌一并展示,供买家点击。 | |
用户通过已存卡支付,您可以将卡品牌标识(logo)、对应的卡品牌、和脱敏后的卡号一并展示,供买家点击。 |
表 1. 支付方式不同呈现方式及用户体验
步骤 3:授权支付
发起授权支付的过程,可以通过 API 或 SDK 两种方式进行集成:
SDK 方式 | API 方式 |
适用于对支付流程中的自定义程度无较高要求、青睐轻量集成的商户。通过减少支付流程中的页面跳转,为用户提供更优质的支付体验,从而提升支付成功率。 | 适用于对支付流程的自定义程度有较高要求且有PCI资质的商户。 |
表 2. 授权支付的不同集成方式说明
如果您未使用独立绑卡能力,您也可以在授权支付阶段为买家提供独立绑卡能力。
步骤 4:(可选)取消授权支付
您可以通过调用 取消 接口,进行授权支付的撤销。当以下情况发生时,需要撤销授权支付:
- 在买家完成授权支付之后、商户进行请款之前,如果买家申请了退款,则商户需取消该买家的授权。
- 商户风控系统判断该笔交易有风险。
如果撤销授权支付成功,取消 请求的响应中 result.resultStatus 字段值为 S
。
关于如何发起授权支付取消,请参考取消。
步骤 5:发起请款
您可以选择以下请款方式中的其中一种:
- 自动请款:买家授权完成后 APO 会自动立即发起请款。请款成功后,APO 会向您发送请款结果通知。请款模式在如下情况下均为自动请款:
- 手动请款:买家授权完成后,您需要自己通过 请款 接口发起请款请求。需注意的是,请款的总金额需等于买家授权的金额。您需指定 支付 或 支付会话创建 接口的 paymentFactor.captureMode 字段值为
MANUAL
。
注意:卡支付场景下,建议您以请款成功作为发货依据。
关于如何发起请款等更多请款相关内容,请参考请款。