延时分账

最近更新时间：2023.8.11

1. 产品介绍

1.1 简介

分账的应用场景：服务商向分销/商户分账，商户与下属的用户之间基于业务订单收款的分账。分账有实时分账与延时分账两种模式。您可以结合业务场景选择实时或延时分账（分账+延迟能力的组合使用）。分账功能的实现主要通过接口与控台两种方式。控台上操作比较适合大额低频的分账场景。对于小额高频的交易建议您实时系统自动分账。

延时分账

对于有延迟（事后）分账需求的客户，收款交易完成，资金进入延迟户不可结算、不可取现；需要通过交易确认接口来确认（可分账）到商户基本户；延迟确认支持多次部分确认。 分账+延迟能力的组合使用，商户收款交易完成后需单独触发指令来完成分账。

涉及交易类型：扫码支付、银联统一线上收银台支付、网银支付、手机WAP支付、余额支付、快捷支付。

资金流：收款交易完成，资金进入延迟户（延迟分账业务专用账户），不可结算、不可取现，需要通过交易确认接口来确认交易并分账到商户或指定用户基本户，支持多次部分确认。

延迟分账支持如下分账规则：

接口发起。交易时delay_acct_flag传入延迟分账标签，交易确认时在acct_split_bunch中指定各分账方以及分账金额（保留两位小数）。 对于延时分账支持两种方案：

1. 通过控台对延时订单发起分账操作。这种方式只支持商户向下属用户分账；
2. 商户可以调接口发起分账。接口发起分账支持商户与商户、商户与用户之间分账；

注：建议一笔订单不要同时支持接口与控台分账，以免出错

业务流程图：

1.2 应用场景

• 分账场景：电商、团购类商户用于分润、提成等；
• 分账规则来源：接口发起、控台配置；
• 分账形式：
  • 商户对平台及多用户（商户收款资金分账给平台及平台上的用户）
  • 商户对平台（商户收款资金只分给平台）
  • 平台对商户及对用户（平台收款分账给入驻在平台上的商户）
  • 其他（除以上场景外的模式，需单独申请沟通）；
• 资金流：

延迟分账场景描述：

商户A 医院主营医美业务，甲、乙、丙分别为不同科室的美容医生，用户来到A医院做美容项目，需要一年三个周期完成，每个周期都有涉及到甲、乙、丙三个科室医生的项目，都需要给对应医生以劳务分成。

例如，用户购买了价值20000的美容项目，一次性延迟订单收款总金额 20000元，分为三个治疗阶段，在每个治疗阶段完成后，对固定金额进行确认分账。第一阶段消费10000元，甲医生要收取 2000元 劳务分成，乙医生要收取 1000元 劳务分成，丙医生要收取 500元，A 公司收款 6500元。手续费为 A 公司承担。

实现步骤：

1、通过用户管理接口创建分账账户（该分账方开户过程如果已经调用开通过分账账户，无需重复调用开通）：【企业/个人用户基本信息开户接口 】【用户业务入驻接口】为甲、乙、丙分账方开通汇付账户且完成绑卡、结算或取现的配置。假设用户开户后甲、乙、丙的汇付账户为6666000020060002、6666000020060003、6666000020060004，A账户为6666000020060001。

2、商户A发起20000.00元的收款交易，并在支付请求中指定delay_acct_flag = Y，交易成功将资金收款到延迟户。

3、美容客户如期来进行了第一阶段的治疗，治疗完成后，商户A对第一疗程的费用10000.00元，通过调用汇付的延迟交易的交易确认接口进行交易确认分账给参与医生甲、乙、丙，指定acct_split_bunch分账对象如下：

"acct_split_bunch":"{"acct_infos":[{"div_amt":"6500.00","huifu_id":"6666000020060001"},{"div_amt":"2000.00","huifu_id":"6666000020060002"},{"div_amt":"1000.00","huifu_id":"6666000020060003"},{"div_amt":"500.00","huifu_id":"6666000020060004"}]}"后续疗程确认资金（分账）流程如上。

该接口为同步接口，同步会告知结果，如果同步返回未拿到成功（S）/失败（F）终态的话，需通过交易确认查询接口来查询各个分账方的分账状态trans_stat交易确认明细状态。

注意：

• 交易确认接口，可确认金额总和=原收款交易金额-原交易手续费金额，即是扣除交易手续费后的金额，不得超额，否则会导致确认失败。
• 分账手续费在交易确认时才收取的。
• 延时分账的交易，交易手续费是一阶段扣收，二阶段扣收分账手续费；

以前面的例子来说明，交易手续费0.6%，分账手续费0.1%；

交易手续费20000*0.6%=120元；内扣场景下，进入延时户的资金为10000-120=9880元；

甲、乙、丙的分账手续费：

• 内扣场景下，各分账接收方按分账金额承担手续费。分别是2000*0.1%=2元；1000*0.1%=1元；500*0.1%=0.5元。
• 外扣场景下由分账手续费承担方统一承担；（2000+1000+500）*0.1=3.5元；

多次分账情形下如何按每次分账发生额计费收取；

1.3 名词定义及功能补充说明

1. 分账方：指资金出款方，客户A分给客户B，客户A指分账方。
2. 分账接收方：指资金接收方，客户A分给客户B，客户B指分账接收方。分账接收方可以是渠道、代理、商户、企业或个人用户。分账方与分账接收方必须同属于一个渠道商或平台商户（包括渠道与平台商户自身）。
3. 用户：汇付对分账接收方角色的定义。
4. 延迟分账：指付款人支付后资金先进入汇付延时户，交易订单完成后，客户根据业务模式，调取交易确认接口发起分账指令，将资金转给收款方与分账接收方。
5. 实时分账：指交易订单和分账订单同步完成。
6. 汇付基本户：可以取现，可以结算。普通交易订单和实时分账交易订单，资金默认进入汇付基本户。
7. 汇付延迟户：不可以取现，不可以结算。带延迟分账标记的交易订单资金会进入汇付延迟户，调取交易确认接口可以把汇付延迟户中的资金划转到指定汇付基本户中。
8. 最大分账比例：指该商户下的订单可以分出去多少金额比例，举例：商户A设置了最大分账比例80%，商户A下有交易订单收款100元，该交易订单最多可以分给其他商户80元。
9. 分账其他补充说明：

• 分账是否支持撤销交易：支持选择开关；
• 分账是否支持退货交易：支持选择开关；
• 支持商户自定义分账比例，申请分账最大比例：0-100 的数值，支持两位小数，单位%；
• 支持一次最多有15个分账接收方；
• 分账手续费收取方式：实收；
  • 分账手续费与交易手续费是两种不同的费用类型。
  • 分账手续费只在分账发生时才计费；
  • 如果一笔交易有分账是外扣，则交易手续费与分账手续费分别计费，但一笔收取。
  • 如果一笔交易有分账是内扣，则交易手续费与分账手续费分别计费，分别向收款方与分账接收方收取。
  • 分账手续费内扣时是向各分账接收方分别收取的。
• 分账手续费扣收类型：内扣、外扣；
• 手续费外扣商户号：商户、服务商、用户均支持；
• 手续费外扣账户号：该商户下的任意账户号；

2. 接入前准备

2.1业务开通及配置

2.1.1开通分账业务

汇付运营人员为服务商开通分账

1. 服务商开通基础收款能力：如微信支付、支付宝支付、网银支付等（本章节不再阐述，如需请联系客户经理提供对应指引）；
2. 服务商需要开通具备分账权限，下属商户才可以开通分账权限，需先联系汇付申请开通服务商的分账权限以及分账费率底价配置。如果有大比例分账需求（超过20%比例的），也需要提前向汇付报备，涉及到一些场景说明文件的提交。

服务商为商户开通分账

控台开通：
开通路径：服务商控台-【商户管理】-【商户信息】-【查看】-【分账配置】-【编辑】

开通分账基础材料：《分账双方合作项目照片》、《分账接收方营业执照》、《分账接收方身份证明文件》、《分账接收方营业场所照片》，企业商户分账比例超过20%，个人商户分账比例超过10%，需额外提供补充材料：

当选择场景涉及线上，分账模式为其他，此场景下还需要补充业务模式、资金流向、功能开通用途说明、与分账方的合同等

2.1.2 分账用户开通

1、参与分账的分账接收方需要在汇付体系下开通账户，通过用户管理接口开通并入驻用户。

用户开通

根据商户主体（有无营业执照）选择企业、个人商户基本信息开户接口进行用户开户；

企业用户基本信息开户API/个人用户基本信息开户API

创建用户所需的相关资料

1. 企业用户：企业用户资料：法人证件、营业执照、结算账户类型（对公、对私）、结算卡、协议、联系人手机号等；
2. 个人用户：个人用户资料：身份证、营业执照、结算卡、协议、手机号等；

用户入驻

用户业务入驻接口给用户进行绑卡、结算/取现的权限、周期的配置以及费率配置。

用户业务入驻API

2、使用控台创建用户

路径：商户控台-【商户管理】-【用户创建】-选择企业、个人商户，填写基本信息、结算配置、取现配置、资料上传。

2.2 分账模板配置

（该模板仅用于控台操作对延迟订单按照模板进行分账操作）

控台分账配置路径：商户控台-【分账管理】-【分账模板配置】-【普通分账规则】（延时）

注意：对现有模板的任何操作都不会影响已按此模板分账订单。

注：

• 您的一笔业务收款的自留比例不能低于一个最低比例，系统会给出相应提示。否则您的模板创建成功了，但应用这个模板发起分账时会被系统拦截。

• 这个比例是您在申请开通分账业务时为您设置的。如果您的这个比例需要调整需要提交说明材料，汇付审批之后才可以调整这个比例。

2.3发起延时分账

支持多次部分分账，分账完成后，资金会随商户配置的结算周期自动结算到用户的银行账户中；

控台和接口都支持延时分账；

控台发起分账

商户控台-【分账管理】-【分账发起】-【分账申请】、【批量分账】

支持多次部分分账，所以这里查询到的都是未完成全额分账的延时待分账订单。

选择一笔延时分账订单点击【分账申请】打开分账操作弹框。选择一个分账模板，系统根据模板自动计算出各分账方的分账金额。此时您可以调整分账方比如删除或新增一个分账收款方，输入对应的比例或分账金额。

注：

• 系统会自动计算并调整已分账金额、未分账金额、各方本次分账比例；
• 系统会自动累计本次及之前该订单累计分账金额，以及您自留部分的金额是否满足规定。
• 弹框的底部是该订单历史分账流水记录；

分账申请为发起单笔交易分账，批量分账勾选多笔交易一起分账，分账时可选择之前配置的延迟分账模板

接口发起分账

参见下文交易流程说明

2.4分账退款

支持接口和控台端操作退款；

控台退款：
商户控台-【交易结算】-【交易流水】-【详情】-【退款】

1. 延时分账未分账前，退款方式与普通交易退款方式一致

 2. 延时分账已完成分账，点击退款会显示分账记录，需完成所分账退款方可发起交易退款

3. 当分账退款因账户余额不足无法完成退款时，被分账方为服务商和商户，可通过充值解决，如被分账方为用户，无法充值，则可通过退款垫资方式处理

接口退款
参见下文延时分账退款流程

2.5查询分账明细

控台查询路径：商户控台-【分账管理】-【分账明细】

2.6 对接准备

第一步：密钥获取

联调之前需要先获取公私钥，参见公私解钥参数获取说明；

第二步：公共参数获取

登录服务商/商户控台后，可在开发设置-开发者信息中，获取sys_id，product_id参数信息；

3. 开发指引

3.1 对接规范

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

SDK示例：Java SDK

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

3.2 确认业务配置

控台查询分账功能/延迟功能是否配置完成

1. 通过服务商控台-【代理商管理】-【代理商查看】-查看-业务信息

2. 商户控台-【我的信息管理】-【我的信息】-业务信息查询-分账信息

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

3.3 系统调用流程

3.3.1 交易流程

以聚合正扫接口手续费内扣场景为例，其他交易类型接口规则一样：

延迟分账交易有两个步骤：1）延迟交易  2）延迟交易确认

• 第一步：指定交易为延迟交易：

模式一：商户开通非强制延迟权限，需要在发起支付交易收款时指定下是否延迟交易标识（delay_acct_flag=Y），将该笔交易指定为延迟交易（不指定即为实时交易）；

模式二：商户开通强制延迟权限，交易无需指定delay_acct_flag参数，商户所有交易默认都是延迟交易。

注：延迟交易的订单，无需在交易接口中传入分账串，请在交易确认接口中传入分账串。

• 第二步：对延迟交易进行交易确认

分账延迟交易须通过交易确认接口指定分账对象（acct_split_bunch）来实现延迟分账，延迟交易支持多次部分确认分账，分账完成后，资金会随用户配置的结算周期自动结算到用户的银行账户中；

注意：交易确认接口，可确认金额总和=原收款交易金额-原交易手续费金额，即是扣除交易手续费后的金额，不得超额，否则会导致确认失败。

对延迟交易进行交易确认：交易确认接口

注意：该接口为同步接口，同步会告知结果，如果同步返回未拿到成功（S）/失败（F）终态的话，需通过交易确认查询接口来查询各个分账方的分账状态trans_stat交易确认明细状态。

3.3.2 延时分账退款流程

• 未完成分账的延迟分账交易可直接进行交易退款，退还到买家账户；

延迟交易未分账场景

延迟交易已分账场景

已做了分账或部分分账的交易：

1. 调用交易确认退款接口，将已分账的金额退回延时户；必须依据原分账交易逐笔退款；
2. 调用交易退款接口，将延时户中的金额退给付款人；

注：

• 斗拱退款默认退还手续费；
• 两个阶段都可以部分退款，如果是从延时户做退款，要保证这笔交易在延时户中的可退款资金充足。否则要先从收款人与分账接收人的账户中把资金退到延时户。
• 如果交易确认退款接口不传分账串则默认全额退款；
• 如果是延迟分账+已分账（全部分账）+部分退款5元。先调用交易确认退款接口，传入分账串（分账串总额为49.9元，计算方法5*0.001 = 0.005元 ,然后向上取整取0.01元手续费，5-0.01 = 49.9元）；然后调交易退款接口，不传分账串，交易金额传5元
• 如果被分账方资金不够，交易确认退款会失败，需要补足被分账方资金。
• 如果没有办法补足被分账方资金，那么交易确认退款需要垫资处理，垫资方一定要参与了分账，否则无法垫资。参考垫资退款说明；

通过交易退款接口完成退款，支持分账交易的部分退款和全额退款，

如果是全额退款无需指定分账串，部分退款需要指定分账对象参数（acct_split_bunch）指明各分账参与方、参与方退款金额（金额不得大于分账金额）。

• 已完成分账的延迟分账交易需先进行交易确认退款，再进行交易退款，才可以退还到买家账户：

第一步：通过交易确认退款接口，将交易确认分账的金额退还到分账商户的延迟户（要保证各分账方账户余额充足，不然会导致交易确认退款失败，退回部分可重新交易确认分账）

• 实时分账退款垫资，可通过调用交易退款接口完成，目前仅扫码交易退款接口支持退款垫资；
• 分账退款手续费也支持按比例退还；

第二步：通过交易退款接口完成退款，支持分账交易的部分退款和全额退款。

如果是全额退款无需指定分账串，部分退款需要指定分账对象参数（acct_split_bunch）指明各分账参与方、参与方退款金额（金额不得大于分账金额）。

备注：

1.实时分账仅支持一次分账，分账串最多默认支持15个被分账方对象。

2.延迟分账支持多次分账，每次分账串最多默认支持15个被分账方对象。

3.多次分账的延迟分账，退款的时候要多次分账退款。

4.延迟交易的订单，不要在聚合正扫接口中传入分账串，需要分账的时候，在交易确认接口中传入分账串。

3.3.3 分账配置

接口开通：

实时分账需要商户通过分账配置接口开通分账权限、最大分账比例以及分账手续费配置。最大分账比例20以下是免审的，20以上需要审核，结果以异步方式通知。

通过分账配置接口进行开通分账并配置；

分账配置接口入参需关注acct_split_bunch_list字段：

分账规则：交易商户开通分账权限时有两种规则（通过rule_origin分账规则来源参数指定）可根据商户业务自行选择：

         01 接口发起：交易时指定acct_split_bunch分账对象，指定参各分账方以及各分账方分账金额（保留两位小数）。

         02 控台配置：该规则是配置固定的分账方、分账比例，交易时无需指定分账对象参数默认读取分账权限开通时配置的的分账对象串来填充分账对象，以配置对象来进行分账。

3.3.4 商户业务开通

延迟权限开通： 商户业务开通接口

关注字段：

和商户业务开通修改接口

关注字段：

延迟权限：

• 延迟权限分为非强制延迟（delay_flag 延迟入账开关），权限开通后，交易默认是非延迟交易，指定了延迟标记参数（delay_acct_flag     是否延迟交易）的交易订单为延迟交易；
• 强制延迟（forced_delay_flag 商户开通强制延迟标记）。权限开通后，商户的所有交易默认全部都是延迟交易。延迟交易必须进行交易确认，确认部分的资金才会入账到基本户才可结算、取现。

3.3.5 查询分账明细

接口查询：分账明细查询

3.3.6 对账流程

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

方案一：控台下载；

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

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

3.3.7 异步通知

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

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

注意事项：

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

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

详见异步通知使用说明。

4. API列表

5.常见问题

1. 延迟交易退款报："resp_desc":"退款金额大于待确认金额","trans_stat":"F"

问题原因：已确认的延迟交易订单，如需退款要先进行交易确认撤销后再进行扫码退款

解决方案：先进行交易确认撤销，再进行扫码退款操作。

2. 支付接口调用报错："resp_desc":"数据权限认证失败"

问题原因：商户信息校验没有通过。

解决方案：

1）检查报文中的产品号（product_id）是否填写正确；

2）检查报文中的系统号（sys_id）和商户号（huifu_Id） 从属关系是否正确。

3. 退款场景参考

• 场景1、延迟分账：未分账+全额退款
  答：商户A调取扫码交易退款接口，不传分账串，交易金额传100

• 场景2、延迟分账：未分账+部分退款50元
  答：商户A调取扫码交易退款接口，传入分账串总和50，交易金额传50

• 场景3、延迟分账：已分账（部分分账50元）+全额退款
  答：商户A调取交易确认退款接口，分账串传50，接口完成后，调取扫码交易退款接口，不传分账串，交易金额传100

• 场景4、延迟分账：已分账（部分分账50元）+部分退款
  答：1.部分退款30小于已分账金额50，此时未分账金额49.97
  方式1：商户A调取扫码交易退款接口:交易金额传30，从未确认余额出，其中汇付退款手续费30/100*0.03=0.009 保留两位小数向上取整为0.01，从未确认资金出款30-0.01=29.99， 退款后待确认金额为49.97-29.99=19.98。
  方式2：如果其中的资金涉及到被分账方，首先调取交易确认退款接口，分账串传30-30/100*0.03=29.99，然后调取扫码交易退款接口:交易金额传30。
  2. 部分退款60大于已分账金额50，此时未分账金额49.97。部分退款60，汇付退还手续费金额为60/100*0.03=0.018 取0.02，从延迟户出资60-0.02=59.98 。首先调取交易确认退款接口，分账串传59.98-49.97=10.01元，然后调取扫码交易退款接口:交易金额传60.

• 场景5、延迟分账：已分账（全部分账）+全额退款
  答：商户A调取交易确认退款接口，不传分账串，接口完成后，调取扫码交易退款接口，不传分账串，交易金额传100

• 场景6、延迟分账：已分账（全部分账）+部分退款50元
  答：商户A调取交易确认退款接口，传入分账串（分账串总额为49.98元，计算方法50/100*0.03 = 0.015元 ,然后向上取整取0.02元，50-0.02 = 49.98元），接口完成后，调取扫码交易退款接口，不传分账串，交易金额传50元

• 场景7：实时分账：部分退款50
  答：商户A调取扫码交易退款接口，传入分账串（分账串总额50元），交易金额传50元

• 场景8：实时分账：全部退款
  答：商户A调取扫码交易退款接口，不传分账串，交易金额传100

更多问题详见斗拱开发者社区：https://service.dougong.net/t/qa