Antom, leading provider of tailored payment solutions

卡支付

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

集成前提

在正式开始集成之前,您需要完成以下准备工作:
  • 注册开发者中心账号。
  • 在开发者中心设置您的密钥。
  • 设置异步通知接收地址。
欲知更多详情,请参考 Alipay+ 的 集成指南。

支付流

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

集成步骤

支付场景的集成步骤如下:
  1. 展示支付方式。
  2. 发起授权支付,并展示支付结果。
  3. (可选) 取消授权支付。
  4. 发起请款。

步骤一:展示支付方式

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

1. 获取支付方式

您可调用 咨询 接口 (POST/v1/payments/consult)来获取卡支付方式列表:
在请求中,您需要传入该笔订单的金额、支付的端类型、地区信息;返回参数会告知您该支付渠道的 logo、正确显示名以及当前状态。具体可参照 咨询 接口说明。请注意以下字段信息:
参数名
必填/选填
描述
merchantRegion
OPTIONAL
商户展业区域,该字段值为两个字母的 ISO code。默认不传,但如果您的展业地区是新加坡或中国香港、且想要查询的支付方式是卡支付,则需要传入此字段。可能的值为:
  • SG
  • HK
paymentAmount
REQUIRED
该笔交易的交易币种和金额。
env
REQUIRED
该笔支付进行的设备环境,比如 PC 浏览器、手机应用、手机浏览器。
表 1. 咨询接口关键请求参数说明
在响应中,返回对应的支付方式列表,几个关键字段如下:
返回值
描述
paymentOptions.paymentMethodType
卡支付方案下,该字段为 CARD
paymentOptions.paymentMethodRegion
卡支付方案下,该字段为商户签约卡的发卡地信息。该字段值为两个字母的 ISO code 或 GLOBAL,例如:
  • GLOBAL:代表该卡为国际卡。
  • FR:代表该卡为法国卡,发卡地为法国。
  • KR:代表该卡为韩国卡,发卡地为韩国。
  • BR: 代表该卡为巴西卡,发卡地为巴西。
paymentOptions.enabled
支持的支付方式在当前情况下是否可用
paymentOptions.paymentOptionDetail.supportCardBrands.logo
卡支付方案下,该字段为卡品牌的 logo。可能的返回值可参考 卡品牌列表。
paymentOptions.paymentOptionDetail.supportCardBrands.cardBrand
卡支付方案下,该字段为支持的卡品牌。可能的返回值可参考 卡品牌列表。
paymentOptions.paymentOptionDetail.funding
卡的类型。可能返回的枚举值有:
  • CREDIT: 表示卡类型为信用卡。
  • DEBIT: 表示卡类型为借记卡。
表 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。
【注意】卡支付场景下,建议您以请款成功作为发货依据。
关于如何发起请款等更多请款相关内容,请参考 请款。