6.接口对接指引

6.1 商户进件

6.1.1云商通2.0进件

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

6.1.1 存量收银宝商户

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

6.2 协议签约

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

6.3 商户收款

6.3.1云商通2.0支付接口

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

6.3.2 存量支付交易

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

特别说明：

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

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

6.4 商户收款资金分账

1.以下2个场景下的商户收款交易，均支持平台抽佣：

（1）通过云商通2.0【消费申请】接口发起的交易

（2）直接对接收银宝接口的交易

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

相关接口：

【批量分账】

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

【批量分账文件查询】

【批量下载回盘文件】

6.5 资金提现

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

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

涉及接口：【提现申请】

6.5 交易退款

1. 场景：在资金收款/分账抽佣后，消费者发起退款申请，此时需要进行资金分账的退款。

2.业务规则：

• 支持已分账抽佣or未分账抽佣的消费交易进行退款；
• 支持部分退款or全额退款；
• 针对已分账抽佣的交易，支持仅退回渠道金额or仅退回分账资金or同时退回；

3. 涉及到的相关接口为【退款申请】、【订单结果通知】、【订单状态查询】、【订单详情查询】；

4. 针对消费申请发起退款，支持1年内的订单发起退款；

5.渠道退款金额为退回到消费者银行卡的资金，此金额总计不超过原消费交易的订单金额；

6.资金确认退款金额为退回到收款方在途资金的余额，此金额总计不超过原消费交易的结算金额。