目录
7.1 接口列表说明
分类 |
对应接口 |
接口代码 |
接口说明 |
文件上传 |
文件上传 |
/ |
将上传的附件信息转化为文件流,获取fileId。后续会员进件、资料补录等接口上传图片、PDF等文件时,上送该文件的fileId。 |
会员进件 |
会员进件接口 |
1070 |
上送基本信息、考察材料、开通的产品等信息,申请开通通联的支付服务。 |
会员进件结果通知 |
1071 |
会员进件的结果通知,支付服务开通成功,则响应支付商户号。 |
|
会员进件状态查询 |
1072 |
主动查询会员进件的状态 |
|
会员产品信息管理 |
1073 |
增删改查会员入网的支付产品信息 |
|
合规补录审核结果通知 |
1074 |
商户进件出号并签订通联支付的特约商户服务协议后,人工会对商户进件入网的相关证照材料进行合规性审核,并通过该接口通知审核结果。 |
|
会员合规状态查询接口 |
1075 |
主动查询会员的合规审核结果 |
|
会员合规补录api接口 |
1076 |
针对合规审核失败的会员,支持接口信息的补录 |
|
渠道子商户查询 |
1077 |
查询会员在微信、支付宝侧的商户号 |
|
渠道认证状态查询 |
1078 |
查询会员在微信、支付宝侧的认证情况 |
|
AT统一认证h5 |
1079 |
协助会员完成微信、支付宝侧的商户认证接口 |
|
AT认证状态异步通知 |
1080 |
使用AT统一认证h5接口,认证结果的通知 |
|
会员合规补录api异步通知 |
1081 |
合规补录api接口补录信息提交成功或提交失败的通知 |
|
会员产品信息修改异步通知 |
1082 |
会员费率修改后的通知接口 |
|
会员认证类 |
企业会员实名开户 |
1020 |
企业会员实名注册,开户的接口 |
会员资料补录 |
1022 |
会员补录营业执照等材料的接口 |
|
个人会员实名及绑卡 |
1010 |
个人会员注册实名,开户的接口 |
|
会员绑定手机号申请 |
1030 |
会员绑定手机号,用于协议的签署等 |
|
会员解绑手机号(原手机号)申请 |
1031 |
会员解绑手机号 |
|
确认绑定/解绑手机号 |
1032 |
会员绑定/解绑手机号的确认接口 |
|
会员线上协议签约申请 |
1050 |
会员申请签署协议的接口 |
|
会员协议签约结果通知 |
1052 |
会员签约结果的通知接口 |
|
查询会员信息 |
1027 |
查询会员的基本信息、银行卡等信息的接口 |
|
账户余额查询 |
1023 |
查询会员余额的接口 |
|
终端信息管理 |
4001 |
反扫终端的报备管理 |
|
交易类 |
消费申请 |
2085 |
交易收款接口 |
批量分账 |
2092 |
交易结算后的资金分账接口,对【消费申请】的订单,按订单号发起分账 |
|
批量分账文件处理结果通知 |
批量分账接口的处理结果通知 |
||
批量分账文件查询 |
批量(多次)分账接口主动查询处理结果的接口 |
||
批量分账回盘文件下载 |
批量分账接口的处理结果回盘下载接口 |
||
提现申请 |
2290 |
从会员余额提现到会员银行卡 |
|
订单关闭 |
2295 |
针对微信、支付宝的订单,在客户未支付的情况下主动关闭订单 |
|
交易结果查询类接口 |
订单状态查询 |
3001 |
查询订单的状态 |
订单详情查询 |
3002 |
查询订单的详情 |
|
对账文件下载类 |
应用集合对账文件下载 |
4002 |
下载对账文件用于对账 |
7.2 主要场景及功能
7.2.1 会员进件
会员进件是指收单商户(卖方)在平台系统内完成商户号注册和认证的过程,此过程确保了卖方的身份合法性和交易安全性。
具体接入流程如下:
7.2.2 业务参与方注册
业务参与方,在平台系统中一般是指和收单商户存在真实业务合作关系的分账方(企业、个体户、个人等),此业务参与方在接受分账资金前,需要在系统内完成注册、实名以及分账协议的签署等操作,以确保资金分账的合规性。
注:该分账场景需一户一审。
具体接入流程如下:
7.2.3 支付收款
提供网上收银、POS、扫码、统一收银台等多样的支付产品形态,支付能力一点接入,支持全场景收款,并支持ISV进行统一的对账处理。
接入说明:
收款时,需调用【消费接口】,针对收款会员要求为进件生成的商户号收款,订单类型为“消费”,订单子类型为“商户收款”。
7.2.4 分账结算
基于真实的业务场景,通联侧提供资金分账能力。在收款商户协议授权的前提下,从结算资金中按比例分账给业务合作方,同时支持平台抽取软件服务费,避免二清风险。
接入说明:
平台抽佣及分账交易,需要在原消费收款交易发生后的D+1/T+1日发起(即支付侧已经将D日的商户收款资金存放至“待结算”账户),针对一笔收款订单,仅支持发起一次分账交易。
- 当涉及平台抽佣、分账时,需先完成抽佣、分账协议的签署,而后调用【批量分账接口】将资金抽佣分账到对应的业务参与方账户余额中,此时可以进行提现;
- 当不涉及平台抽佣、分账时,直接调用【批量分账接口】,将收款方的结算资金确认为可提现状态。
7.3 账户结构
KA客户版(非统一资金管理模式)账户采用 总分 结构,平台在云商通二代自动开立“应用待结算资金”总账户和应用方“待结算户”子账户,会员实名注册后,自动开立“待结算户”子账户。
针对“待结算户”,下设“在途资金”、“可用资金”两个维度,分别进行账务处理。
- 在途资金:支付侧将D日的商户收款资金存放至“待结算”账户时,默认存放至“在途资金”,此部分资金不可提现。支付侧将商户收款的资金存放至“待结算”账户的时间,为【会员进件】时上送的“clearTimeRule-结算时间”。
- 可用资金:调用【批量分账】接口后,将商户资金从“在途资金”释放至“可用资金”,此部分资金可提现。
7.4 账务处理逻辑
【场景案例】(正负代表增加、减少)
1、消费者在收款收款商户消费100元,系统生成“消费-商户收款”的订单,系统无账务处理。
2、T+1日:支付侧按照【会员进件】设置的“clearTimeRule-结算时间”,向商户的“待结算”账户存放:99.4元(假设0.6%的支付手续费,日结:100元-100*0.6%=),对应的收银宝商户号对应会员为A。
账户交易类型 |
待结算户 |
备注 |
|
可用 |
在途 |
||
结算 |
A:+99.4 |
D1/T1结算时动账 |
3、收款方A调用【批量分账接口】分账确认99.4元,业务参与方B分账10元,平台抽佣5元
订单类型 |
订单子类型 |
账户交易类型 |
待结算户 |
备注 |
|
可用 |
在途 |
||||
转账 |
订单分账 |
资金确认 |
A:+99.4 |
A:-99.4 |
交易发生时动账 |
分账 |
A:-10 B:+10 |
||||
平台抽佣 |
A:-5 平台:+5 |
4、收款方A调用【提现接口】提现20元,平台抽佣5元
订单类型 |
订单子类型 |
账户交易类型 |
待结算户 |
备注 |
|
可用 |
在途 |
||||
提现 |
商户提现 |
提现 |
A:-15 |
交易发生时动账 |
|
平台抽佣 |
A:-5 平台:+5 |
7.5 业务流程
从商户入网到资金收款、分账提现,涉及到的整体业务流如下:
7.5.1 会员进件
商户从入网到功能正常允许进行收款,涉及到的先后顺序如下:
7.5.1.1 会员进件管理
7.5.1.1.1 业务场景及规则
- 场景:平台中的卖方在通联进行收单商户的注册、入网,开通商户号和“待结算户”。
- 业务规则:
- 商户进件时,默认为该商户赋予“收单商户”的角色;
- 支持企业、事业单位、个体工商户、个人性质的商户进件,开通收银宝商户号,对于个体工商户、个人性质的商户,支持绑定对私卡;
- 商户进件认证流程:按顺序触发--企业工商要素验证->法人实名认证->对私银行账户认证/对公银行账户信息留存;
- 商户进件全部认证通过后收银宝商户号开通成功,同时开通“待结算户”,商户会员编号和“待结算户”关联对应。
7.5.1.1.2 流程说明
- 涉及到的接口有【会员进件接口】、【会员进件结果通知】、【会员进件状态查询】;
- 【会员进件接口】各验证流程进行验证的要素信息如下:
- 企业工商要素验证:企业名称,统一信用代码、法人名称;
- 法人认证要素:法人姓名,法人证件号、法人证件类型;
- 对私银行认证要素:法人名称、法人证件号、法人证件类型、银行卡号、预留手机号;
- 任一验证流程验证失败,商户进件均失败,支持通过此接口再次进行实名入网;
7.5.1.2 合规审核管理
7.5.1.2.1 业务场景及规则
- 场景:商户进件完成、协议签署完成后,通联运营人员会对该商户信息进行合规审核,合规审核通过后商户限额解除。
- 业务规则:
- 是否需要进行合规补录,根据合规补录的审核结果来决定,当审核不通过时才需要进行合规补录;
- 针对同一个收银宝商户号,如合规审核不通过,支持补录后再次进入审核状态,一般仅有2次补录机会,最多支持5次补录;
7.5.1.2.2 流程说明
- 涉及到的接口有【合规审核结果通知】、【会员合规状态查询】、【会员合规补录api】;
- 协议签署完成后,一般会在1个工作日内完成合规状态的审核,审核的结果通过【合规审核结果通知】接口通知给客户,也可主动调用【会员合规状态查询】接口主动查询;
- 当合规审核不通过时,可调用【会员合规补录api】接口将审核不通过的信息重新补充。
- 如多次补录后,仍未审核通过,则此商户号将会被冻结,此时需要重新进件开通新的商户号。
- 合规审核操作及状态流程如下:
7.5.1.3 AT认证管理
7.5.1.3.1 业务场景及规则
- 场景:商户进件完成后,需要在微信、支付宝侧完成商户号的实名认证操作,认证完成后才可以正常交易。
- 业务规则:
- 涉及到微信支付宝交易时,需要完成微信支付宝侧的商户认证流程;
7.5.1.3.2 流程说明
- 涉及到的接口有【AT统一认证h5接口】、【AT认证状态异步通知】、【渠道认证状态查询接口】;
- 通过【AT统一认证h5接口】发起微信、支付宝的商户认证时,认证结果会以通知的形式提供给商户,也可以主动调用【渠道认证状态查询接口】主动查询认证结果。
7.5.1.4 产品信息管理
7.5.1.4.1 业务场景及规则
- 场景:商户进件完成后,需要查询、增加、删除、修改该商户的开通产品及费率信息。
- 业务规则:
- 请求类型有:增删改查,一次仅能发起一个请求类型的交易;
7.5.1.4.2 流程说明
- 涉及到的接口有【会员产品信息管理】、【会员产品信息修改异步结果通知】;
- 通过【会员产品信息管理】发起商户开通产品、费率的变更,审核结果会以通知的形式提供给商户。
- 调用产品信息管理接口管理商户在支付产品以及费率信息,待人工审核通过后生效。
7.5.2 业务参与方注册
7.5.2.1 个人会员开户
7.5.2.1.1 业务场景及规则
- 场景:个人业务参与方注册实名,开通“待结算户”。
- 业务规则:
- 个人会员注册时,必须上传业务方对应的会员角色;
- 实名开户必填字段为“姓名+身份证号”,如需绑定银行卡(提现时需要),则需要额外补充“银行卡号+手机号”;
- 针对开户的证件类型,暂仅支持“身份证”;
- 开户成功后系统会开立“待结算户”,商户会员编号和“待结算户”关联对应。
7.5.2.1.2 流程说明
- 调用【个人会员实名及绑卡】接口完成会员的实名以及绑卡动作;
- 会员实名后,通过此接口支持绑定多张银行卡。
- 企业会员(个体工商户)实名后,可以通过此接口绑定法人卡,暂时仅支持个体户绑定一张法人卡。
7.5.2.2 企业会员开户
7.5.2.2.1 业务场景及规则
- 场景:企业业务参与方注册实名,开通“待结算户”。
- 业务规则:
- 企业会员注册时,必须上传业务方对应的会员角色;
- 支持企业性质为企业、个体工商户、事业单位的会员开通“待结算户”,对于个体工商户支持绑定对私法人卡;
- 企业实名开户认证流程:
- 法人证件类型为身份证:按顺序触发:企业工商要素验证->法人实名认证->对私银行账户认证/对公银行账户信息留存;
- 法人证件类型为非身份证:按顺序触发:企业工商要素验证->对私银行账户认证/对公银行账户信息留存通过后,接口响应开户失败,待补充资料人工审核通过后实名成功,此时开通“待结算户”;
- 开户成功后系统会开立“待结算户”,商户会员编号和“待结算户”关联对应。
7.5.2.2.2 流程说明
- 企业开户调用的接口为【企业会员实名开户接口】,影印件补录的接口为【会员资料补录接口】;
- 【企业会员实名开户接口】各验证流程进行验证的要素信息如下:
- 企业工商要素验证:企业名称,统一信用代码、法人名称;
- 法人认证要素:法人姓名,法人证件号、法人证件类型;
- 对私银行认证要素:法人名称、法人证件号、法人证件类型、银行卡号、预留手机号;
- 任一验证流程验证失败,企业实名均失败,支持通过此接口再次进行实名认证;
- 同一个企业会员,通过此接口暂时仅支持绑定一张银行卡,个体工商户支持绑定法人对私卡,企业/事业单位仅支持绑定企业对公户。
7.5.3 会员手机号管理
7.5.3.1 业务场景及规则
- 场景:会员/收单商户在签约前需先绑定手机号,此时才可以进行ISV相关协议的在线签约。
- 业务规则:
- 个人会员/商户绑定手机号,仅支持绑定本人真实手机号;
- 企业会员/商户绑定手机号,支持绑定法人本人手机号或者授权人手机号。绑定授权人手机号时,需法人人脸验证通过,签署完成签字授权书即绑定成功。
7.5.3.2 流程说明
- 涉及到的接口有【会员绑定手机号申请】、【确认绑定/解绑手机号】、【会员解绑手机号申请】;
- 会员绑定手机号成功后,支持解除绑定后重新进行手机号的绑定;
- 绑定授权人手机号,且为线下签署授权书的场景时,涉及接口有【线下协议文件上传】、【会员协议签约结果通知】。
7.5.4 会员协议管理
7.5.4.1 业务场景及规则
- 场景:会员在接受分账资金时需要先完成分账协议的签署,收单商户在交易前需先完成收单协议、平台抽佣协议等的签署。
- 业务规则:
- 收单商户必须完成收单协议、平台抽佣协议的签署,涉及业务合作方分账时,可以同时签署完成分账协议;
- 签署分账协议时,上送的分账方必须符合业务规则,且已经完成手机号的绑定;此时针对收款商户和分账方会各有一条协议链接,双方均完成则分账协议签约完成。
- 收款方涉及给多个业务合作方进行分账时,需要签署完成多份分账协议。
3. 协议签署说明:按照【行业版角色管控】菜单管理的会员角色签约规则,仅协议签约完成可进行交易;
前置条件 | 会员角色 | 协议类型 | 协议签署方 | 交易管控 | 说明 |
会员状态有效 | 收款方、分账方 |
授权委托协议: 《授权委托书》 |
商户、授权人、被授权人 | 1050--协议签约接口 | 绑定被授权人手机号时,需要签订授权委托协议,绑定成功,则可作为其他协议签约时接收短信的手机号 |
会员状态有效 & 绑定手机号 | 收款方 |
支付入网协议: ----标准的收银宝支付入网协议,可能存在多份 |
通联、收单商户 | 2085--消费收款接口 | 签署完成此协议后可作为收单商户进行收款,否则该收款方不允许发起消费交易 |
平台抽佣协议: 《客户委托结算授权函》 |
收单商户 | 2092--批量分账接口 | 当存在平台抽佣场景时,可在协议签署时上送抽佣的最大比例,协议签约成功后平台可进行抽佣 | ||
分账协议: 《委托结算业务合作协议》 |
收单商户、通联、分账方 | 2092--批量分账接口 | 按照会员角色管控分账方和收款方是否需要签订分账协议,需要签订,则签约成功才可分账 | ||
分账方 |
分账协议: 《委托结算业务合作协议》 |
收单商户、通联、分账方 | 2092--批量分账接口 | 按照会员角色管控分账方和收款方是否需要签订分账协议,需要签订,则签约成功才可分账 |
- 协议示例:[附件]平台相关协议样例.zip,包括授权委托协议、支付入网协议、平台抽佣协议、分账协议示例。
7.5.4.2 流程说明
- 涉及到的接口有【会员线上协议签约申请】、【会员协议签约结果通知】;
- 调用接口进行协议签约时,协议类型为:3--平台相关协议;
- 协议签署时,短信验证码均发送到会员绑定的手机号上面;
- 签约的协议比例更新时,支持调用本接口再次发起签约。新的协议置“签约成功”后,则原协议置为“已失效”状态。
7.5.5 消费收款
7.5.5.1 业务场景及规则
- 场景:平台中的卖方注册成功后,使用通联提供的收单能力完成消费收款。
- 业务规则:
- 收款方商户状态正常且开通对应的支付产品时,方可进行相关交易;
- 消费收款时,上传的收款方会员和收银宝商户号需一一对应;
- 消费收款时不记账,待支付侧将商户收款的资金存放至“待结算户”后,调用【批量分账】接口后,将商户资金从“在途资金”释放至“可用资金”,此部分资金可提现。
7.5.5.2 流程说明
- 涉及到的相关接口为【消费接口】、【订单结果通知】、【订单状态查询】、【订单详情查询】、【订单关闭】;
- 平台调用【消费接口】发起资金的收款,交易成功后会通过【订单结果通知】接口通知给平台,也可以调用【订单状态查询】接口主动获取订单状态;
- 针对微信支付宝相关交易,支持调用【订单关闭】接口关闭未支付的订单。
7.5.6 分账抽佣
7.5.6.1 业务场景及规则
- 场景:需要将商户收款资金抽佣、分账到相关方的余额中。
- 平台抽佣:入账会员为平台方。
- 分账:入账会员为其他业务参与方。
- 业务规则:
- 平台抽佣及分账交易,需要在原消费收款交易发生后的D+1/T+1日发起(即支付侧已经将D日的商户收款资金存放至“待结算”账户),;
- 一笔消费订单仅可进行一次分账抽佣;
- 一笔消费通过【批量分账】接口发起平台抽佣或分账后,系统将自动将原消费订单的“结算金额”(即扣除了支付手续费)资金释放至可用资金;
- 分账抽佣的资金比例,需满足真实的业务场景和协议签署比例的约束;
7.5.6.2 流程说明
- 涉及到的相关接口为【批量分账】、【批量分账文件处理结果通知】、【批量分账文件查询】、【批量分账回盘文件下载】;
- 针对一笔消费订单,如该笔订单的手续费配置为日结,则可分账抽佣的金额为订单金额-手续费金额,即此笔订单实际的结算金额;
- 订单的结算金额第二天可通过【订单状态查询】、【订单详情查询】接口获取,也可在第二天的集合对账文件中获取;
- 【批量分账】接口为按文件批量处理的模式,可以同时上传多笔消费订单进行分账抽佣,处理完成后通过【批量分账文件结果通知】接口告知处理状态,也可以通过【批量分账文件查询】接口进行主动查询;
- 【批量分账文件结果通知】返回的仅为文件的处理状态,非批量分账交易的交易结果,交易结果以【批量分账回盘文件下载】接口回盘文件中的交易状态为准。
- 如不涉及分账抽佣时,则无需上传平台抽佣和资金分账金额,此时资金从收款方会员的在途全额确认到可用资金。
7.5.7 资金退款
7.5.7.1 业务场景及规则
- 场景:在资金收款/分账抽佣后,消费者发起退款申请,此时需要进行资金分账的退款。
- 业务规则:
- 支持已分账抽佣or未分账抽佣的消费交易进行退款;
- 支持部分退款or全额退款;
- 针对已分账抽佣的交易,支持仅退回渠道金额or仅退回分账资金or同时退回;
7.5.7.2 流程说明
- 涉及到的相关接口为【退款申请】、【订单结果通知】、【订单状态查询】、【订单详情查询】;
- 针对消费申请发起退款,支持1年内的订单发起退款;
- 渠道退款金额为退回到消费者银行卡的资金,此金额总计不超过原消费交易的订单金额;
- 资金确认退款金额为退回到收款方在途资金的余额,此金额总计不超过原消费交易的结算金额。
7.5.8 提现结算
7.5.8.1 业务场景及规则
- 场景:收单商户资金分账抽佣后,可以将资金提现到对应会员的银行卡中。
- 业务规则:
- 收单商户提现到账的银行卡,必须为进件接口上送的结算账户,即唯一的结算银行卡;
- 业务参与方会员提现到账的银行卡,需为会员绑定的银行卡;
- 资金提现时,支持平台抽佣,同时会受到提现时间的限制,默认为7:00-20:00。
7.5.8.2 流程说明
- 涉及到的相关接口为【提现申请】、【订单结果通知】、【订单状态查询】、【订单详情查询】;
- 针对会员的可用余额发起资金提现,资金结算到会员绑定的银行卡;
- 提现交易成功时,回通过【订单结果通知】接口告知此笔提现交易的结果,也可主动调用【订单状态查询】接口主动进行查询。
7.5.9 统一对账
7.5.9.1 业务场景及规则
- 场景:D+1日生成D日交易的集合对账文件,供客户下载进行对账。
- 业务规则:
- 对账内容包含所有成功订单;
- 对账文件支持txt、excel两种格式,可按需下载;
- 对账文件后续有新增字段的可能,开发时需要兼容此场景。
7.5.9.2 流程说明
- 涉及到的相关接口为【应用集合对账文件下载】;
- 一般在D+1日的10点钟左右生成集合对账文件,如10点钟获取不到,可过段时间重新获取;
- 集合对账文件中含有结算金额,该金额为每笔订单可分账抽佣的金额。