卡支付
本文介绍如何使用接口集成卡支付方式,本方案适用于对支付流程的自定义程度有较高要求的商户。
集成前提
在正式开始集成之前,您需要完成以下准备工作:
- 注册开发者中心账号。
- 在开发者中心设置您的密钥。
- 设置异步通知接收地址。
欲知更多详情,请参考 Alipay+ 的 集成指南。
支付流
所有通过卡支付方式进行的收单交易均为授权请款模式,即分为授权(Authorization)和请款(Capture)两步。买家在结账时先授权付款,授权阶段会锁定特定金额的付款资金,仅在请款成功后才将资金转移到您的账户。默认情况下,Alipay+ 会为您自动发起并完成请款,但您也可以选择自行调用接口发起并完成请款。
卡支付的整体流程如下图所示:
图 1. 授权支付与请款流程
图 2. 取消授权支付流程
集成步骤
支付场景的集成步骤如下:
- 展示支付方式。
- 发起授权支付,并展示支付结果。
- (可选) 取消授权支付。
- 发起请款。
步骤一:展示支付方式
建议您通过接入 咨询 接口动态获取当前支持的卡支付方式及对应的卡品牌图标,并对获取到的支付方式进行合理呈现。当然您也可以通过静态图标的形式展示对应的支付方式。
1. 获取支付方式
您可调用 咨询 接口 (POST/v1/payments/consult)来获取卡支付方式列表:
在请求中,您需要传入该笔订单的金额、支付的端类型、地区信息;返回参数会告知您该支付渠道的 logo、正确显示名以及当前状态。具体可参照 咨询 接口说明。请注意以下字段信息:
参数名 | 必填/选填 | 描述 |
merchantRegion | OPTIONAL | 商户展业区域,该字段值为两个字母的 ISO code。默认不传,但如果您的展业地区是新加坡或中国香港、且想要查询的支付方式是卡支付,则需要传入此字段。可能的值为:
|
paymentAmount | REQUIRED | 该笔交易的交易币种和金额。 |
env | REQUIRED | 该笔支付进行的设备环境,比如 PC 浏览器、手机应用、手机浏览器。 |
表 1. 咨询接口关键请求参数说明
在响应中,返回对应的支付方式列表,几个关键字段如下:
返回值 | 描述 |
paymentOptions.paymentMethodType | 卡支付方案下,该字段为 CARD |
paymentOptions.paymentMethodRegion | 卡支付方案下,该字段为商户签约卡的发卡地信息。该字段值为两个字母的 ISO code 或 GLOBAL,例如:
|
paymentOptions.enabled | 支持的支付方式在当前情况下是否可用 |
paymentOptions.paymentOptionDetail.supportCardBrands.logo | 卡支付方案下,该字段为卡品牌的 logo。可能的返回值可参考 卡品牌列表。 |
paymentOptions.paymentOptionDetail.supportCardBrands.cardBrand | 卡支付方案下,该字段为支持的卡品牌。可能的返回值可参考 卡品牌列表。 |
paymentOptions.paymentOptionDetail.funding | 卡的类型。可能返回的枚举值有:
|
表 2. 咨询接口关键返回参数说明
2. 呈现支付方式
呈现支付方式时,建议您按照如下方式进行:
呈现支付方式的方式 | 用户体验 |
用户首次支付,您可以将卡支付logo(paymentOptions.logo)和对应的卡品牌(paymentOptions.paymentOptionDetail.supportCardBrands.logo)一并展示,供买家点击。 | |
用户通过已存卡支付,您可以将卡支付logo(paymentOptions.logo)、对应的卡品牌(paymentOptions.paymentOptionDetail.supportCardBrands.logo)和mask后的卡号一并展示,供买家点击。 |
表 3. 支付方式不同呈现方式及用户体验
步骤二:授权支付
在买家确认支付后,您需调用 支付 接口发起授权支付。关于如何调用接口完成授权支付,详情参见 授权支付。
步骤三:(可选)取消授权支付
您可以通过调用 取消 接口,进行授权支付的撤销。当以下情况发生时,需要撤销授权支付:
- 在买家完成授权支付之后、商户进行请款之前,如果买家申请了退款,则商户需取消该买家的授权。
- 商户风控系统判断该笔交易有风险。
如果撤销授权支付成功,取消 请求的响应中 result.resultStatus 字段值为 S。
步骤四:发起请款
您可以选择以下请款方式中的其中一种:
- 自动请款:买家授权完成后 Alipay+ 会自动立即发起请款。请款成功后,Alipay+ 会向您发送请款结果通知。请款模式在如下情况下均为自动请款:
- 您指定 paymentFactor.captureMode 字段的值为
AUTOMATIC
。 - 支付 接口的 paymentFactor.captureMode 字段为空或不传。
- 手动请款:买家授权完成后的七天内,您需要自己通过 请款 接口发起请款请求,否则 Alipay+ 会自动将买家冻结的资金解除。需注意的是,请款的总金额需等于买家授权的金额。您需指定 支付 接口的 paymentFactor.captureMode 字段值为
MANUAL
。
【注意】卡支付场景下,建议您以请款成功作为发货依据。
关于如何发起请款等更多请款相关内容,请参考 请款。