6.接口对接指引


6.1 商户进件

6.1.1云商通二代进件

调用云商通二代的相关接口,完成商户进件出号、认证。

功能概述 相关接口
调用相关接口,完成支付商户出号

【文件上传】

【会员进件接口】

【会员进件结果通知】

【会员进件状态查询】

商户需完成渠道的实名认证、合规性审核等流程。

(注:商户完成支付服务协议签约后,会进行合规性审核)

【会员产品信息管理】

【合规审核结果通知】

【会员合规状态查询接口】

【会员合规补录api接口】

【渠道子商户查询】

【渠道认证状态查询】

【AT统一认证h5】

【AT认证状态异步通知】

 

6.1.1 存量收银宝商户

针对已经在通联完成支付入网的商户,仅需调用【会员绑定收银宝商户】接口,上送会员号、角色、收银宝商户号信息,即可在云商通二代创建会员并开立账户,无需重复进件

 

6.2 业务参与方注册认证

注:此部分仅针对于支付商户需要向其他业务参与方(如供应商)分账时对接,若只有平台抽佣,则不涉及这部分的会员注册认证,该功能需要一户一审。

功能概述 相关接口
需要参与分账的业务方,完成注册、实名认证、影印件采集

【文件上传】

【企业会员实名开户】

【会员资料补录】

【个人会员实名及绑卡(申请)】

【个人会员实名及绑卡(确认)】

 

6.3 协议签约

上述商户完成进件、业务参与方完成实名认证后,需绑定手机以及相关协议签约。

功能概述 相关接口
入网的商户、分账方,均需完成手机号绑定,用于后续的协议签约

【会员绑定手机号申请】

【会员解绑手机号(原手机号)申请】

【确认绑定/解绑手机号】

【线下协议文件上传】

包括3类协议:支付入网协议、分账协议、平台抽佣协议:

收款方(收单商户)可三份协议一起签约;
分账方仅需要签订“分账协议(收单商户与分账方)”一份协议;

注:商户收款资金需分账或平台抽佣的场景,需在商户收款前完成协议签约。

签约完成后商户的资金将自动结算至云商通二代的商户“待结算户”中,用于后续ISV发起分账/平台抽佣。

否则资金将自动结算至商户银行结算账户。

【会员线上协议签约申请】

【会员协议签约结果通知】

 

6.3 商户收款

6.3.1云商通二代支付接口

调用云商通二代【消费申请】接口,完成支付收款。以及相关的【退款申请】、【订单关闭】、【订单状态查询】、【订单详情查询】接口。

6.3.2 存量支付交易

存量已经对接了收银宝支付接口的商户,无需重新对接二代的交易入金类接口,商户收款完成后对接6.4商户收款资金分账 部分的相关接口即可。

特别说明:

1. 针对使用“KA客户版”,资金管理模式为“账后结算”的客户:则需分账/平台抽佣的平台商户,则应属于同一个集团商户下。(云商通二代为按集团商户获取对账单处理交易的逻辑,商户归属问题导致交易不在该集团对账单中的,则无法处理后续的分账/平台抽佣交易)

2. 针对使用“ISV服务版”,资金管理模式为“账后结算”的客户:则需分账/平台抽佣的平台商户,则应属于同一个“交易发起方”下。(云商通二代为按代理商获取对账单处理交易的逻辑,商户归属问题导致交易不在该代理商对账单中的,则无法处理后续的分账/平台抽佣交易)

 

6.4 商户收款资金分账

1. 分账支持2类场景:

(1)平台抽佣

(2)商户收款资金向其他参与方分账

2.以下2个场景下的商户收款交易,均支持分账:

(1)通过云商通二代【消费申请】接口发起的交易

(2)直接对接收银宝接口的交易

3.分账交易需在原消费收款交易发生后的D+1发起。系统对账完成后,通过【批量分账】接口发起分账时,系统按照原消费订单的“结算金额”进行动账处理。
4.一笔线下收款订单,只能分账一次。
5. 无需平台抽佣、无需分账的场景,也需要调用【批量分账】,将原消费收款订单的在途资金转为可用。

相关接口:

【批量分账】

【批量分账文件处理结果通知】

【批量分账文件查询】

【批量下载回盘文件】

 

6.5 资金提现

ISV需为商户、分账会员将完成分账及平台抽佣的资金,提现至银行账户:

(1)商户仅可提现至唯一银行结算账户。
(2)分账会员可提现至绑定银行账户。

涉及接口:【提现申请】


wuxl2 2024年10月24日 15:12 收藏文档