1. 花呗与银行卡分期服务开发指引

1.1 对接规范

调用汇付接口，均采取POST形式提交，数据格式统一为JSON格式，相关SDK及签名方法见链接：

SDK示例：Java SDK

加签验签：v2版接口加签验签

1.2 确认业务配置

分期配置查询

可通过商户分期配置详情查询可以查询商户分期配置信息。

1.3 系统调用流程

1.3.1 交易流程

• 花呗分期

接入步骤：

1. 调用 聚合正扫 接口时trade_type根据实际场景传参（支付宝各场景接入方案详见对应指引文档）；
2. 完成支付后，汇付异步通知商户支付状态；

补偿机制：交易查询

a) 商户调用扫码交易查询接口接口，上传原交易日期、原交易订单号等信息查询该订单交易结果；

b) 汇付斗拱系统同步返回该笔支付订单交易结果；

• 银行卡分期

接入步骤：

a) 调用手机WAP支付接口，提交订单：

b) 完成支付后，汇付异步通知商户支付状态；

补偿机制：交易查询

a) 商户调用线上交易查询接口，上传原交易日期、原交易订单号等信息查询该订单交易结果；

b) 汇付斗拱系统同步返回该笔支付订单交易结果；

手机 WAP 支付接口关注以下请参：

1.3.2 退款流程

完整的交易流程还要包括退款。由于用户或者商户的原因需要退款时，商户可以通过本接口将支付款退还给用户，退款成功资金将原路返回。

花呗分期退款参见扫码交易退款接口；退款查询：调用扫码交易退款查询接口，上传原退款请求日期、原退款交易流水号、进行退款交易结果查询；

银行卡分期退款参见线上交易退款接口；退款查询：调用线上退款查询接口，上传原退款请求日期、原退款交易流水号、进行退款交易结果查询。

备注：商贴退款：交易完成15天内（含），支持退分期手续费和交易手续费，超过15天仅支持退交易手续费；

• 原交易请求流水号、原交易全局流水号、原交易微信支付宝的商户单号三选一即可；
• 退款金额不能大于交易金额；由于接口支持多次部分退款，多次退款场景下退款总额不能高于原交易金额；
• 退款也是以异步返回的成功或失败状态为最终结果；
• 一些特殊场景下退款时效可能比较长，注意接口描述文档中的退款时效说明；

1.3.3 对账流程

为了满足商户财务的对账需求，斗拱提供了对账功能。

方案一：控台下载；

方案二：接口获取；参见交易结算对账单查询接口

• 接口下载的对账文件包括以下四类：

• 日对账单类型：包括日结算对账单、日分账对账单、日出金对账单；
• 日交易数据：主要是各种支付交易记录；
• 月结算对账单：按月汇总的结算对账单；
• 月交易数据：按月汇总支付交易记录；

1.3.4 异步通知

针对交易结果，汇付会通过异步消息的方式通知客户系统。

调用汇付接口时上送的异步通知地址为http/https路径：服务器为POST回调，默认超时时间为5秒，超时后会重试3次；不支持HTTP重定向；服务器对应答不是200~300之间的错误，会默认重试3次；异步通知服务器对HTTPS不认证验签和ALLOW_ALL_HOSTNAME_VERIFIER；如商户自定义通知端口，请使用8000-9005内端口，否则无法通知；URL 上请勿附带参数；异步回调请求编码集为：UTF-8；收到通知后请返回状态码“200”,响应异步通知。

注意事项：

同样的异步消息可能会通知多次，因此接收异步消息的处理需做好幂等，保障多次接收到同样的消息处理后结果不变。

在实现异步消息接收的同时，都建议您在重要的业务环节，通过反查接口确认 非终态 支付订单的状态，以保证在发生异步消息延迟或无法送达情况下的支付结果一致性。

详见异步通知使用说明。

2.京东白条服务开发指引

2.1对接规范

调用汇付接口，均采取POST形式提交，数据格式统一为JSON格式，相关SDK及签名方法见链接：

SDK示例：Java SDK

加签验签：v2版接口加签验签

2.2确认业务配置

分期配置查询可通过商户分期配置详情查询可以查询商户分期配置信息。

2.3系统调用流程

交易接口调用时序：

白条分期支付下单注意事项：

1. 下单时请确保商户已开通白条分期支付交易场景下的费率。
2. 下单时请上送正确的下单来源（order_source）。
3. 下单来源为微信小程序时，下单来源类型上送H5，下单后，汇付侧会返回pay_info参数信息，可通过小程序调用方法加工pay_info后跳转至京东白条小程序完成支付。
4. 下单时交易有效期（time_expire）未上送时，系统默认有效期2h。

3. 预授权支付开发指引

3.1 对接规范

调用汇付接口，均采取POST形式提交，数据格式统一为JSON格式，相关SDK及签名方法见链接：

SDK示例：Java SDK

加签验签：v2版接口加签验签

3.2 确认业务配置

登录控台查询预授权是否配置完成

1. 通过服务商控台-【商户管理】-【商户信息】-查询-业务配置

1. 商户控台-【我的信息管理】-【我的信息】-业务信息

1. 通过商户详细信息查询接口来确认相关配置。

3.3 系统调用流程

3.3.1 交易流程

适用对象：需要通过接口实现微信、支付宝预授权功能的商户。（POS终端的请参考终端指引文档）

小程序、公众号、APP等调用API接口进行微信支付宝预授权支付功能：预授权交易发起、预授权交易撤销、预授权交易完成、预授权交易撤销完成。

交易流程图：

交易步骤：

1. 发起预授权交易，调用预授权交易接口
2. 预授权完成，可调用预授权交易完成接口

预授权交易入参需关注以下字段：

预授权交易完成 入参需关注以下字段：

1. 预授权交易以及交易完成查询，可通过扫码交易查询接口进行查询。

3.3.2 撤销流程

1. 如预授权未完成需撤销，调用预授权交易撤销接口完成撤销；
2. 如预授权完成后需撤销交易，调用预授权交易完成撤销接口完成撤销。

预授权交易撤销入参需关注以下字段：

预授权交易完成撤销 入参需关注以下字段：

1. 预授权交易撤销以及完成撤销查询，可通过扫码交易退款查询进行查询

3.3.3 对账流程

为了满足商户财务的对账需求，斗拱提供了对账功能。

方案一：控台下载；

方案二：接口获取；参见交易结算对账单查询接口

• 接口下载的对账文件包括以下四类：

• 日对账单类型：包括日结算对账单、日分账对账单、日出金对账单；
• 日交易数据：主要是各种支付交易记录；
• 月结算对账单：按月汇总的结算对账单；
• 月交易数据：按月汇总支付交易记录；

3.3.4 异步通知

针对交易结果，汇付会通过异步消息的方式通知客户系统。

调用汇付接口时上送的异步通知地址为http/https路径：服务器为POST回调，默认超时时间为5秒，超时后会重试3次；不支持HTTP重定向；服务器对应答不是200~300之间的错误，会默认重试3次；异步通知服务器对HTTPS不认证验签和ALLOW_ALL_HOSTNAME_VERIFIER；如商户自定义通知端口，请使用8000-9005内端口，否则无法通知；URL 上请勿附带参数；异步回调请求编码集为：UTF-8；收到通知后请返回状态码“200”,响应异步通知。

注意事项：

同样的异步消息可能会通知多次，因此接收异步消息的处理需做好幂等，保障多次接收到同样的消息处理后结果不变。

在实现异步消息接收的同时，都建议您在重要的业务环节，通过反查接口确认 非终态 支付订单的状态，以保证在发生异步消息延迟或无法送达情况下的支付结果一致性。

详见异步通知使用说明。

4. 支付宝先享后付开发指引

4.1 对接规范

调用汇付接口，均采取POST形式提交，数据格式统一为JSON格式，相关SDK及签名方法见链接：

SDK示例：Java SDK

加签验签：v2版接口加签验签

4.2 确认业务配置

在控台可查询先享后付的配置信息

1. 服务商控台：

1. 商户控台：

4.3 系统调用流程

4.3.1 整体流程

4.3.2 创建服务单

1. 通过【订单前置判断】，获取source_id，该字段需在【服务单创建】传入；
2. 若业务场景为固定金额模式，请先调用【聚合正扫】下单获取支付单号后在【服务单创建】时传入，若为浮动金额模式，请直接调用【服务单创建】创单，并通过以下方法拉取受理台：

【拉取受理台jsapi】

用于前端唤起对应的用户受理页面完成业务订单创建过程。版本支持：>=2.9.5

示例代码：

my.startOrderService({
    orderId: '202324413151',
    fail: (res) => {
        console.log(res)
    }
})
复制代码复制失败复制成功

1. 消费者侧确认签约授权&下单后，返回结果，请保存返回的服务单单号，用于后续流程中使用；
2. 调用【服务单查询】，可查询服务单的状态；调用【服务单关闭】，结束服务订单；

4.3.3 创建分期单

商家平台调用【分期单创建】，创建分期订单，分期期数请固定填”1“期。该分期订单号用于后续履约扣款时传入，请做好与服务单单号的对应关系。

4.3.4 履约扣款

用户选择芝麻先享下单，确认收货并体验满意后，商家平台基于信用下单金额主动调用 【分期扣款】 向用户发起扣款，需传入服务单单号和其对应的分期单单号。若未能获取到交易终态，可通过【分期扣款查询】查询扣款结果。

4.3.5 退款

调用【分期扣款退款】，对已交易成功的履约扣款订单进行退款，支持全额/部分退款。若未能获取到交易终态，可通过【分期扣款退款查询】查询扣款结果。