补贴支付
1. 产品介绍
1.1 简介
补贴支付即为商户收款时，集团总部或连锁总部（渠道商）会将部分支付手续费金额补贴到收款方的账户，达到客户的营销目的。
- 支持一级渠道商、二级渠道商和总部机构层级进行补贴；
- 支持多个账户进行补贴出款；
- 支持扫码支付和快捷支付与补贴支付结合使用；
- 只支持企业商户，线下、线上场景；
1.2 应用场景
应用场景：连锁机构下属商户营销补贴费用由总部账户（营销户）支付。
对接方式：接口对接，商户在对接过程中不用单独调用补贴支付接口，补贴支付功能集成在现有支付交易接口中，根据相应的规则，传入金额和补贴出款账户等信息即可。
汇付支持：
- 手续费补贴开通
- 手续费补贴配置
- 营销补贴配置
流程图：
1.3 名词定义及说明
【间联模式】：指第三方支付公司通过银联、网联对接支付宝和微信的模式
【手续费实时收取】：默认配置，交易过程中，根据商户配置的手续费率实时计算并收取，实时收取模式下可以指定手续费内扣或手续费外扣。
【手续费内扣】：默认配置，手续费内扣指从交易金额中扣收手续费，比如100元的交易金额，0.6%的手续费率，手续费为0.6元。收款方实际收款为100.00-0.6=99.4元。
【手续费外扣】：是从指定的主体及斗拱账户中扣收手续费，收款方仍是全额收款。这里指定承担手续费的主体通常是商户、平台、渠道。承担方及账户是在控台上配置的；需单独申请开通。
【手续费规则】：
- 交易时手续费默认是内扣，如果商户配置了外扣，可以在调用下单接口时通过【fee_flag】参数指定这笔交易是内扣还是外扣，见【开发指引】-【系统调用流程】-【下单请求支付信息】。
- 交易手续费，按照四舍五入默认计算，举例：0.2334，保留两位小数为0.23元。
- 退款手续费，全额退款为全额退费。
- 退款手续费，部分退款公式为：退款手续费（向上取整）=退款金额*原订单手续费金额/原订单金额。【多次退款累计的手续费差额会合并计算到最后一笔退款】，举例：向上取整为0.011取整为0.02。
2. 接入前准备
2.1 商务准备
-
选择接入模式
-
直签模式：指商户与汇付直接签约。具体流程：商户完成协议签署后，将准备好的入网材料提供给汇付销售人员，由汇付销售人员发起商户入网申请，待审核通过入网成功后，商户联系人将收到短信通知控台账号及密码。
-
服务商模式：指服务商与汇付签约，服务商通过接口或控台方式完成商户入网。具体流程：服务商完成协议签署后，将准备好的入网材料提供给汇付销售人员，由汇付销售人员发起服务商入网申请，待审核通过入网成功后，服务商联系人将收到短信通知控台账号及密码。
-
在斗拱完成商户进件入网
- 直签模式：已有汇付销售人员申请开通，商户无须另行操作；
- 服务商模式：
- 控台入网：参考服务商控台进件流程，渠道商接入指引；
- API入网：企业商户调用 企业商户基本信息入驻接口 、小微商户调用 个人商户基本信息入驻接口 完成开户、绑卡、结算配置。
2.2 对接准备
第一步：密钥获取
联调之前需要先获取公私钥，参见公私解钥参数获取说明；
第二步：公共参数获取
登录服务商/商户控台后，可在开发设置-开发者信息中，获取sys_id，product_id参数信息；
第三步：业务开通及配置
- 控台开通
渠道商控台-【商户管理】-【商户入驻】-配置商户其他支付-补贴支付配置
- 配置账户出金固定金额及账户出金费率
- 开通功能所需材料：《营销补贴协议》、《营销项目相关宣传材料》
- 出金账户：营销户
- 接口开通
调用【商户业务开通】接口，combine_pay_config（营销补贴）下进行配置开通
3. 开发指引
3.1 对接规范
调用汇付接口，均采取POST形式提交，数据格式统一为JSON格式，相关SDK及签名方法见链接：
SDK示例：Java SDK
加签验签：v2版接口加签验签
3.2 确认业务配置
控台查补贴支付是否配置完成
- 渠道商控台-【商户管理】-【商户信息】-补贴支付配置
2、商户控台-【我的信息管理】-【我的信息】-业务信息
- 通过商户详细信息查询接口来确认相关配置。
3.3 系统调用流程
3.3.1 交易流程
详见各场景支付流程，在调用交易接口时上送【combinedpay_data】补贴支付域字段即可；
【combinedpay_data】需关注以下字段：
| 参数 | 中文名 | 必填 | 说明 |
|---|---|---|---|
| huifu_id | 补贴方汇付编号 | Y | 提供补贴资金方的huifu_id； |
| user_type | 补贴方类型 | Y | 补贴方类型：channel-渠道，branch-总部/分支机构，agent-代理； |
| acct_id | 补贴方账户号 | Y | 营销补贴方的虚账户号；示例值：F00900982 |
| amount | 补贴金额 | Y |
注：
-
补贴资金是跟随订单逐笔补贴给商户的；
-
一笔交易可以支持多个补贴方做补贴；最多支持7个补贴方；
-
补贴部分的手续费是单独收取的。比如1000元的交易，渠道商补贴100元，100元的交易手续费是单独收取的；
异步返回关注以下字段：
| 参数 | 中文名 | 说明 |
|---|---|---|
| combinedpay_fee_amt | 补贴支付的手续费 | 补贴支付的手续费金额 |
如果长时间未收到异步结果可以调用扫码交易查询接口或线上交易查询接口查询交易状态；
3.3.2 退款流程
完整的交易流程还要包括退款。支持将原交易的补贴资金退还给补贴方，退款成功资金将原路返回。参见扫码交易退款接口、线上交易退款接口；
关注以下请参：
| 参数 | 中文名 | 必填 | 说明 |
|---|---|---|---|
| huifu_id | 补贴方汇付编号 | Y | 示例值：6666000123120001 |
| user_type | 补贴方类型 | Y | channel-渠道，branch-总部/分支机构，agent-代理； |
| acct_id | 补贴方账户号 | Y | 补贴方出资汇付账户号； |
| amount | 退回补贴金额 | Y | 不能超过补贴金额 |
返参：
| 参数 | 中文名 | 说明 |
|---|---|---|
| combinedpay_fee_amt | 退还补贴支付的手续费 | 按退款比例退还手续费 |
注：
- 退款时，全额退款可以退补贴，但不支持只退补贴；非全额退款时退款分账串必填；
3.3.3 对账流程
为了满足商户财务的对账需求，斗拱提供了对账功能。
方案一：控台下载；
方案二：接口获取；参见交易结算对账单查询接口
- 交易数据文件中有【补贴支付】json串，支付、退款都会有;
4. API列表
| 类型 | 功能 | 描述 |
|---|---|---|
| 应用程序接口 | 商户业务开通 | 为商户开通支付业务 |
5.常见问题
1.交易扣款逻辑
先扣除补贴方渠道商/代理商/机构总部营销户补贴金额，转账至商户过渡户，再进行银行扣款，银行扣款成功后，从商户过渡户把补贴金额转至商户基本户；
异常情况：扫码、快捷交易发起后，用户长时间不完成支付，交易状态处于P，未终态，过渡户的补贴金额无法回退；
处理逻辑1：商户调用关单接口（扫码类），关闭原交易，补贴金额回退补贴方营销户；
处理逻辑2：根据不同交易类型，长时间交易处于P状态，未终态，系统将自动关闭，仅限于组合支付交易，聚合正扫2小时，反扫3分钟，快捷/代扣1小时；
更多问题详见斗拱开发者社区：https://service.dougong.net/t/qa
