7. 业务介绍


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 会员进件

会员进件是指收单商户(卖方)在平台系统内完成商户号注册和认证的过程,此过程确保了卖方的身份合法性和交易安全性。

具体接入流程如下:

云商通二代会员开户功能梳理_ISV版_20240718(1)

7.2.2 业务参与方注册

业务参与方,在平台系统中一般是指和收单商户存在真实业务合作关系的分账方(企业、个体户、个人等),此业务参与方在接受分账资金前,需要在系统内完成注册、实名以及分账协议的签署等操作,以确保资金分账的合规性。

注:该分账场景需一户一审。

具体接入流程如下:

云商通二代会员开户功能梳理_ISV版_20240718(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 业务流程

从商户入网到资金收款、分账提现,涉及到的整体业务流如下:

D:/download/云商通二代会员开户功能梳理_20240628-修订(1).png云商通二代会员开户功能梳理_20240628-修订(1)

7.5.1 会员进件

商户从入网到功能正常允许进行收款,涉及到的先后顺序如下:

7.5.1.1 会员进件管理

7.5.1.1.1 业务场景及规则
  1. 场景:平台中的卖方在通联进行收单商户的注册、入网,开通商户号和“待结算户”。
  2. 业务规则:
  • 商户进件时,默认为该商户赋予“收单商户”的角色
  • 支持企业、事业单位、个体工商户、个人性质的商户进件,开通收银宝商户号,对于个体工商户、个人性质的商户,支持绑定对私卡;
  • 商户进件认证流程:按顺序触发--企业工商要素验证->法人实名认证->对私银行账户认证/对公银行账户信息留存;
  • 商户进件全部认证通过后收银宝商户号开通成功,同时开通“待结算户”,商户会员编号和“待结算户”关联对应。
7.5.1.1.2 流程说明
  1. 涉及到的接口有【会员进件接口】、【会员进件结果通知】、【会员进件状态查询】;
  2. 【会员进件接口】各验证流程进行验证的要素信息如下:
    1. 企业工商要素验证:企业名称,统一信用代码、法人名称;
    2. 法人认证要素:法人姓名,法人证件号、法人证件类型;
    3. 对私银行认证要素:法人名称、法人证件号、法人证件类型、银行卡号、预留手机号;
  3. 任一验证流程验证失败,商户进件均失败,支持通过此接口再次进行实名入网;

7.5.1.2 合规审核管理

7.5.1.2.1 业务场景及规则
  1. 场景:商户进件完成、协议签署完成后,通联运营人员会对该商户信息进行合规审核,合规审核通过后商户限额解除。
  2. 业务规则:
  • 是否需要进行合规补录,根据合规补录的审核结果来决定,当审核不通过时才需要进行合规补录;
  • 针对同一个收银宝商户号,如合规审核不通过,支持补录后再次进入审核状态,一般仅有2次补录机会,最多支持5次补录;
7.5.1.2.2 流程说明
  1. 涉及到的接口有【合规审核结果通知】、【会员合规状态查询】、【会员合规补录api】;
  2. 协议签署完成后,一般会在1个工作日内完成合规状态的审核,审核的结果通过【合规审核结果通知】接口通知给客户,也可主动调用【会员合规状态查询】接口主动查询;
  3. 当合规审核不通过时,可调用【会员合规补录api】接口将审核不通过的信息重新补充。
  4. 如多次补录后,仍未审核通过,则此商户号将会被冻结,此时需要重新进件开通新的商户号。
  5. 合规审核操作及状态流程如下:

7.5.1.3 AT认证管理

7.5.1.3.1 业务场景及规则
  1. 场景:商户进件完成后,需要在微信、支付宝侧完成商户号的实名认证操作,认证完成后才可以正常交易。
  2. 业务规则:
  • 涉及到微信支付宝交易时,需要完成微信支付宝侧的商户认证流程;
7.5.1.3.2 流程说明
  1. 涉及到的接口有【AT统一认证h5接口】、【AT认证状态异步通知】、【渠道认证状态查询接口】;
  2. 通过【AT统一认证h5接口】发起微信、支付宝的商户认证时,认证结果会以通知的形式提供给商户,也可以主动调用【渠道认证状态查询接口】主动查询认证结果。

7.5.1.4 产品信息管理

7.5.1.4.1 业务场景及规则
  1. 场景:商户进件完成后,需要查询、增加、删除、修改该商户的开通产品及费率信息。
  2. 业务规则:
  • 请求类型有:增删改查,一次仅能发起一个请求类型的交易;
7.5.1.4.2 流程说明
  1. 涉及到的接口有【会员产品信息管理】、【会员产品信息修改异步结果通知】;
  2. 通过【会员产品信息管理】发起商户开通产品、费率的变更,审核结果会以通知的形式提供给商户。
  3. 调用产品信息管理接口管理商户在支付产品以及费率信息,待人工审核通过后生效。

7.5.2 业务参与方注册

7.5.2.1 个人会员开户

7.5.2.1.1 业务场景及规则
  1. 场景:个人业务参与方注册实名,开通“待结算户”。
  2. 业务规则:
  • 个人会员注册时,必须上传业务方对应的会员角色;
  • 实名开户必填字段为“姓名+身份证号”,如需绑定银行卡(提现时需要),则需要额外补充“银行卡号+手机号”;
  • 针对开户的证件类型,暂仅支持“身份证”;
  • 开户成功后系统会开立“待结算户”,商户会员编号和“待结算户”关联对应。
7.5.2.1.2 流程说明
  1. 调用【个人会员实名及绑卡】接口完成会员的实名以及绑卡动作;
  2. 会员实名后,通过此接口支持绑定多张银行卡。
  3. 企业会员(个体工商户)实名后,可以通过此接口绑定法人卡,暂时仅支持个体户绑定一张法人卡。

7.5.2.2 企业会员开户

7.5.2.2.1 业务场景及规则
  1. 场景:企业业务参与方注册实名,开通“待结算户”。
  2. 业务规则:
  • 企业会员注册时,必须上传业务方对应的会员角色;
  • 支持企业性质为企业、个体工商户、事业单位的会员开通“待结算户”,对于个体工商户支持绑定对私法人卡;
  • 企业实名开户认证流程:
  1. 法人证件类型为身份证:按顺序触发:企业工商要素验证->法人实名认证->对私银行账户认证/对公银行账户信息留存;
  2. 法人证件类型为非身份证:按顺序触发:企业工商要素验证->对私银行账户认证/对公银行账户信息留存通过后,接口响应开户失败,待补充资料人工审核通过后实名成功,此时开通“待结算户”;
  • 开户成功后系统会开立“待结算户”,商户会员编号和“待结算户”关联对应。
7.5.2.2.2 流程说明
  1. 企业开户调用的接口为【企业会员实名开户接口】,影印件补录的接口为【会员资料补录接口】;
  2. 【企业会员实名开户接口】各验证流程进行验证的要素信息如下:
    1. 企业工商要素验证:企业名称,统一信用代码、法人名称;
    2. 法人认证要素:法人姓名,法人证件号、法人证件类型;
    3. 对私银行认证要素:法人名称、法人证件号、法人证件类型、银行卡号、预留手机号;
  3. 任一验证流程验证失败,企业实名均失败,支持通过此接口再次进行实名认证;
  4. 同一个企业会员,通过此接口暂时仅支持绑定一张银行卡,个体工商户支持绑定法人对私卡,企业/事业单位仅支持绑定企业对公户。

7.5.3 会员手机号管理

7.5.3.1 业务场景及规则

  1. 场景:会员/收单商户在签约前需先绑定手机号,此时才可以进行ISV相关协议的在线签约。
  2. 业务规则:
  • 个人会员/商户绑定手机号,仅支持绑定本人真实手机号;
  • 企业会员/商户绑定手机号,支持绑定法人本人手机号或者授权人手机号。绑定授权人手机号时,需法人人脸验证通过,签署完成签字授权书即绑定成功。

7.5.3.2 流程说明

  1. 涉及到的接口有【会员绑定手机号申请】、【确认绑定/解绑手机号】、【会员解绑手机号申请】;
  2. 会员绑定手机号成功后,支持解除绑定后重新进行手机号的绑定;
  3. 绑定授权人手机号,且为线下签署授权书的场景时,涉及接口有【线下协议文件上传】、【会员协议签约结果通知】。

7.5.4 会员协议管理

7.5.4.1 业务场景及规则

  1. 场景:会员在接受分账资金时需要先完成分账协议的签署,收单商户在交易前需先完成收单协议、平台抽佣协议等的签署。
  2. 业务规则:
  • 收单商户必须完成收单协议、平台抽佣协议的签署,涉及业务合作方分账时,可以同时签署完成分账协议;
  • 签署分账协议时,上送的分账方必须符合业务规则,且已经完成手机号的绑定;此时针对收款商户和分账方会各有一条协议链接,双方均完成则分账协议签约完成。
  • 收款方涉及给多个业务合作方进行分账时,需要签署完成多份分账协议。

     3. 协议签署说明:按照【行业版角色管控】菜单管理的会员角色签约规则,仅协议签约完成可进行交易;

前置条件 会员角色  协议类型 协议签署方 交易管控 说明
会员状态有效 收款方、分账方

授权委托协议:

《授权委托书》 

商户、授权人、被授权人 1050--协议签约接口 绑定被授权人手机号时,需要签订授权委托协议,绑定成功,则可作为其他协议签约时接收短信的手机号
会员状态有效 & 绑定手机号 收款方

支付入网协议:
《通联支付网络服务股份有限公司特约商户业务合作协议》

----标准的收银宝支付入网协议,可能存在多份

通联、收单商户 2085--消费收款接口 签署完成此协议后可作为收单商户进行收款,否则该收款方不允许发起消费交易

平台抽佣协议:

《客户委托结算授权函》

收单商户 2092--批量分账接口 当存在平台抽佣场景时,可在协议签署时上送抽佣的最大比例,协议签约成功后平台可进行抽佣

分账协议:

《委托结算业务合作协议》

收单商户、通联、分账方 2092--批量分账接口 按照会员角色管控分账方和收款方是否需要签订分账协议,需要签订,则签约成功才可分账
分账方

分账协议:

《委托结算业务合作协议》

收单商户、通联、分账方 2092--批量分账接口 按照会员角色管控分账方和收款方是否需要签订分账协议,需要签订,则签约成功才可分账
  1. 协议示例:[附件]平台相关协议样例.zip,包括授权委托协议、支付入网协议、平台抽佣协议、分账协议示例。

7.5.4.2 流程说明

  1. 涉及到的接口有【会员线上协议签约申请】、【会员协议签约结果通知】;
  2. 调用接口进行协议签约时,协议类型为:3--平台相关协议;
  3. 协议签署时,短信验证码均发送到会员绑定的手机号上面;
  4. 签约的协议比例更新时,支持调用本接口再次发起签约。新的协议置“签约成功”后,则原协议置为“已失效”状态。

7.5.5 消费收款

7.5.5.1 业务场景及规则

  1. 场景:平台中的卖方注册成功后,使用通联提供的收单能力完成消费收款。
  2. 业务规则:
  • 收款方商户状态正常且开通对应的支付产品时,方可进行相关交易;
  • 消费收款时,上传的收款方会员和收银宝商户号需一一对应;
  • 消费收款时不记账,待支付侧将商户收款的资金存放至“待结算户”后,调用【批量分账】接口后,将商户资金从“在途资金”释放至“可用资金”,此部分资金可提现。

7.5.5.2 流程说明

  1. 涉及到的相关接口为【消费接口】、【订单结果通知】、【订单状态查询】、【订单详情查询】、【订单关闭】;
  2. 平台调用【消费接口】发起资金的收款,交易成功后会通过【订单结果通知】接口通知给平台,也可以调用【订单状态查询】接口主动获取订单状态;
  3. 针对微信支付宝相关交易,支持调用【订单关闭】接口关闭未支付的订单。

7.5.6 分账抽佣

7.5.6.1 业务场景及规则

  1. 场景:需要将商户收款资金抽佣、分账到相关方的余额中。
  2. 平台抽佣:入账会员为平台方。
  3. 分账:入账会员为其他业务参与方。
  4. 业务规则:
  • 平台抽佣及分账交易,需要在原消费收款交易发生后的D+1/T+1日发起(即支付侧已经将D日的商户收款资金存放至“待结算”账户),;
  • 一笔消费订单仅可进行一次分账抽佣;
  • 一笔消费通过【批量分账】接口发起平台抽佣或分账后,系统将自动将原消费订单的“结算金额”(即扣除了支付手续费)资金释放至可用资金;
  • 分账抽佣的资金比例,需满足真实的业务场景和协议签署比例的约束;

7.5.6.2 流程说明

  1. 涉及到的相关接口为【批量分账】、【批量分账文件处理结果通知】、【批量分账文件查询】、【批量分账回盘文件下载】;
  2. 针对一笔消费订单,如该笔订单的手续费配置为日结,则可分账抽佣的金额为订单金额-手续费金额,即此笔订单实际的结算金额;
  3. 订单的结算金额第二天可通过【订单状态查询】、【订单详情查询】接口获取,也可在第二天的集合对账文件中获取;
  4. 【批量分账】接口为按文件批量处理的模式,可以同时上传多笔消费订单进行分账抽佣,处理完成后通过【批量分账文件结果通知】接口告知处理状态,也可以通过【批量分账文件查询】接口进行主动查询;
  5. 【批量分账文件结果通知】返回的仅为文件的处理状态,非批量分账交易的交易结果,交易结果以【批量分账回盘文件下载】接口回盘文件中的交易状态为准。
  6. 如不涉及分账抽佣时,则无需上传平台抽佣和资金分账金额,此时资金从收款方会员的在途全额确认到可用资金。

7.5.7 资金退款

7.5.7.1 业务场景及规则

  1. 场景:在资金收款/分账抽佣后,消费者发起退款申请,此时需要进行资金分账的退款。
  2. 业务规则:
  • 支持已分账抽佣or未分账抽佣的消费交易进行退款;
  • 支持部分退款or全额退款;
  • 针对已分账抽佣的交易,支持仅退回渠道金额or仅退回分账资金or同时退回;

7.5.7.2 流程说明

  1. 涉及到的相关接口为【退款申请】、【订单结果通知】、【订单状态查询】、【订单详情查询】;
  2. 针对消费申请发起退款,支持1年内的订单发起退款;
  3. 渠道退款金额为退回到消费者银行卡的资金,此金额总计不超过原消费交易的订单金额;
  4. 资金确认退款金额为退回到收款方在途资金的余额,此金额总计不超过原消费交易的结算金额。

7.5.8 提现结算

7.5.8.1 业务场景及规则

  1. 场景:收单商户资金分账抽佣后,可以将资金提现到对应会员的银行卡中。
  2. 业务规则:
  • 收单商户提现到账的银行卡,必须为进件接口上送的结算账户,即唯一的结算银行卡;
  • 业务参与方会员提现到账的银行卡,需为会员绑定的银行卡;
  • 资金提现时,支持平台抽佣,同时会受到提现时间的限制,默认为7:00-20:00。

7.5.8.2 流程说明

  1. 涉及到的相关接口为【提现申请】、【订单结果通知】、【订单状态查询】、【订单详情查询】;
  2. 针对会员的可用余额发起资金提现,资金结算到会员绑定的银行卡;
  3. 提现交易成功时,回通过【订单结果通知】接口告知此笔提现交易的结果,也可主动调用【订单状态查询】接口主动进行查询。

7.5.9 统一对账

7.5.9.1 业务场景及规则

  1. 场景:D+1日生成D日交易的集合对账文件,供客户下载进行对账。
  2. 业务规则:
  • 对账内容包含所有成功订单;
  • 对账文件支持txt、excel两种格式,可按需下载;
  • 对账文件后续有新增字段的可能,开发时需要兼容此场景。

7.5.9.2 流程说明

  1. 涉及到的相关接口为【应用集合对账文件下载】;
  2. 一般在D+1日的10点钟左右生成集合对账文件,如10点钟获取不到,可过段时间重新获取;
  3. 集合对账文件中含有结算金额,该金额为每笔订单可分账抽佣的金额。

tangjh2 2024年10月24日 15:58 收藏文档