卡支付

花匠小妙招
2024-12-03 18:22

本文介绍如何使用接口集成卡支付方式，本方案适用于对支付流程的自定义程度有较高要求的商户。

集成前提

在正式开始集成之前，您需要完成以下准备工作：

注册开发者中心账号。在开发者中心设置您的密钥。设置异步通知接收地址。

欲知更多详情，请参考 Alipay+ 的集成指南。

支付流

所有通过卡支付方式进行的收单交易均为授权请款模式，即分为授权（Authorization）和请款（Capture）两步。买家在结账时先授权付款，授权阶段会锁定特定金额的付款资金，仅在请款成功后才将资金转移到您的账户。默认情况下，Alipay+ 会为您自动发起并完成请款，但您也可以选择自行调用接口发起并完成请款。

卡支付的整体流程如下图所示：

图 1. 授权支付与请款流程

图 2. 取消授权支付流程

集成步骤

支付场景的集成步骤如下：

展示支付方式。发起授权支付，并展示支付结果。(可选) 取消授权支付。发起请款。

步骤一：展示支付方式

建议您通过接入咨询接口动态获取当前支持的卡支付方式及对应的卡品牌图标，并对获取到的支付方式进行合理呈现。当然您也可以通过静态图标的形式展示对应的支付方式。

1. 获取支付方式

您可调用咨询接口（POST/v1/payments/consult）来获取卡支付方式列表：

在请求中，您需要传入该笔订单的金额、支付的端类型、地区信息；返回参数会告知您该支付渠道的 logo、正确显示名以及当前状态。具体可参照咨询接口说明。请注意以下字段信息：

表 1. 咨询接口关键请求参数说明

在响应中，返回对应的支付方式列表，几个关键字段如下：

表 2. 咨询接口关键返回参数说明

2. 呈现支付方式

呈现支付方式时，建议您按照如下方式进行：

表 3. 支付方式不同呈现方式及用户体验

步骤二：授权支付

在买家确认支付后，您需调用支付接口发起授权支付。关于如何调用接口完成授权支付，详情参见授权支付。

步骤三：（可选）取消授权支付

您可以通过调用取消接口，进行授权支付的撤销。当以下情况发生时，需要撤销授权支付：

在买家完成授权支付之后、商户进行请款之前，如果买家申请了退款，则商户需取消该买家的授权。商户风控系统判断该笔交易有风险。

如果撤销授权支付成功，取消请求的响应中 result.resultStatus 字段值为 S。

步骤四：发起请款

您可以选择以下请款方式中的其中一种：

自动请款：买家授权完成后 Alipay+ 会自动立即发起请款。请款成功后，Alipay+ 会向您发送请款结果通知。请款模式在如下情况下均为自动请款：您指定 paymentFactor.captureMode 字段的值为 AUTOMATIC。支付接口的 paymentFactor.captureMode 字段为空或不传。手动请款：买家授权完成后的七天内，您需要自己通过请款接口发起请款请求，否则 Alipay+ 会自动将买家冻结的资金解除。需注意的是，请款的总金额需等于买家授权的金额。您需指定支付接口的 paymentFactor.captureMode 字段值为 MANUAL。

【注意】卡支付场景下，建议您以请款成功作为发货依据。

关于如何发起请款等更多请款相关内容，请参考请款。