支付

2023-05-09 09:47

所有通过卡支付方式进行的收单交易均为授权请款模式，即分为授权（Authorization）和请款（Capture）两步。买家在结账时先授权付款，授权阶段会锁定特定金额的付款资金，仅在请款成功后才将资金转移到您的账户。值得注意的是，您需要在授权成功之后的7天内发起请款，否则资金的冻结将自动解除。

集成步骤

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

注意：在授权支付阶段，可以通过 API 方式或 SDK 方式进行集成。

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

您可调用咨询接口（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. 咨询接口关键返回参数说明

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

呈现支付方式的方式	用户体验
用户首次支付，您可以将卡支付logo（paymentOptions.logo）和对应的卡品牌（paymentOptions.paymentOptionDetail.supportCardBrands.logo）一并展示，供买家点击。
用户通过已存卡支付，您可以将卡支付logo（paymentOptions.logo）、对应的卡品牌（paymentOptions.paymentOptionDetail.supportCardBrands.logo）和mask后的卡号一并展示，供买家点击。

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

发起授权支付的过程，可以通过 API 或 SDK 两种方式进行集成：

SDK 方式	API 方式
适用于对支付流程中的自定义程度无较高要求、青睐轻量集成的商户。通过减少支付流程中的页面跳转，为用户提供更优质的支付体验，从而提升支付成功率。	适用于对支付流程的自定义程度有较高要求的商户。

表 4. 授权支付的不同集成方式说明

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

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

授权支付成功之后的七天内，您需要通过调用请款接口（POST/v1/payments/capture）完成请款，否则 Alipay 会自动将买家的资金冻结解除。需注意，请款的总金额应小于等于授权的金额。关于如何发起请款，详情请参考请款。