Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

卡支付

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

集成前提

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

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

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

支付流

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

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

授权支付@3x.png

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

取消授权支付@3x.png

图 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)一并展示,供买家点击。

image

用户通过已存卡支付,您可以将卡支付logo(paymentOptions.logo)、对应的卡品牌(paymentOptions.paymentOptionDetail.supportCardBrands.logo)和mask后的卡号一并展示,供买家点击。

image

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

步骤二:授权支付

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

步骤三:(可选)取消授权支付

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

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

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

步骤四:发起请款

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

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

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

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