垫资退款
1. 产品介绍
1.1 简介
1、电商平台场景下经常会有全额退款的需求。由于存在平台分佣，全额退款需要平台退分佣。有些情况 下平台不愿退还分佣就要求商户垫分佣部分，商户如果愿意就需要⽃拱系统⽀持商户垫资退款。
2、商户基本户资金受监管每日交易额需结算监管户，导致账户在没有新入账的情况下无资金用于历史交易的退款，商户可指定充值户为垫资退款账户，用于退款。
1.2 应用场景
实时退款场景
退款时：
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 商务准备
-
选择接入模式
-
直签模式：指商户与汇付直接签约。具体流程：商户完成协议签署后，商户需要准备好入网材料提供给汇付销售人员，汇付收到后会尽快为商户发起入网申请，待审核通过入网成功后，商户联系人将收到短信通知控台账号及密码。
-
服务商模式：指服务商与汇付签约，服务商通过接口或控台方式完成商户入网。具体流程：服务商完成协议签署后，服务商需要准备好入网材料提供给汇付销售人员，汇付收到后会尽快为服务商发起入网申请，待审核通过入网成功后，服务商联系人将收到短信通知控台账号及密码。
-
在斗拱完成商户进件入网
- 直签模式：已有汇付销售人员申请开通，商户无须另行操作；
- 服务商模式：
- 控台入网：参考服务商控台进件流程，渠道商接入指引http://paas.huifu.com；
- API入网：企业商户调用 企业商户基本信息入驻接口 、小微商户调用 个人商户基本信息入驻接口 完成开户、绑卡、结算配置。
2.2 对接准备
第一步：密钥获取
联调之前需要先获取公私钥，参见公私解钥参数获取说明；
第二步：公共参数获取
登录服务商/商户控台后，可在开发设置-开发者信息中，获取sys_id，product_id参数信息；（如控台未展示，请联系对接群内汇付技术助手提供）
第三步：业务开通及配置
1： 渠道商控台为商户开通“退款垫资功能”
2： 商户登录控台在【账户管理】【账户管理】菜单下创建一个充值户，并为充值户开通退款垫资功能；
接口暂不支持开通。
3. 开发指引
3.1 对接规范
调用汇付接口，均采取POST形式提交，数据格式统一为JSON格式，相关SDK及签名方法见链接：
SDK示例：Java SDKhttp://paas.huifu.com
加签验签：v2版接口加签验签http://paas.huifu.com
3.2 系统调用流程
3.2.1 退款流程
传⼊参数指定退款类型为垫资退款、垫资 ⼈、垫资账户类型；
关注以下请参：
| 参数 | 中文名 | 必填 | 说明 |
|---|---|---|---|
| loan_flag | 是否垫资退款 | N | Y 是垫资出款， N 是普通出款， 为空默认N；示例值：N |
| loan_undertaker | 垫资承担者 | N | 垫资方的huifu_id；为空: 各自承担。不为空走第三方垫资。 目前支持商户垫资。垫资方一定参与了交易分账，否则不支持垫资。 |
| loan_acct_type | 垫资账户类型 | N | 01:基本户, 05: 充值户, 默认充值户；示例值：05 |
3.2.2 异步通知
针对交易结果，汇付会通过异步消息的方式通知客户系统。
调用汇付接口时上送的异步通知地址为http/https路径：服务器为POST回调，默认超时时间为5秒，超时后会重试3次；不支持HTTP重定向；服务器对应答不是200~300之间的错误，会默认重试3次；异步通知服务器对HTTPS不认证验签和ALLOW_ALL_HOSTNAME_VERIFIER；如商户自定义通知端口，请使用8000-9005内端口，否则无法通知；URL 上请勿附带参数；异步回调请求编码集为：UTF-8；收到通知后请返回状态码“200”,响应异步通知。
注意事项：
同样的异步消息可能会通知多次，因此接收异步消息的处理需做好幂等，保障多次接收到同样的消息处理后结果不变。
在实现异步消息接收的同时，都建议您在重要的业务环节，通过反查接口确认 非终态 支付订单的状态，以保证在发生异步消息延迟或无法送达情况下的支付结果一致性。
详见异步通知使用说明。
4. API列表
| 类型 | 功能 | 描述 |
|---|---|---|
| 应用程序接口 | 扫码交易退款 | 本接口将支付款退还给用户，退款成功资金将原路返回 |
| 应用程序接口 | 交易确认退款 | 本接口将已确认的订单金额退回至原商户账户。 |
5.常见问题
- 支付接口调用报错：“resp_desc”：“数据权限认证失败”
问题原因：商户信息校验没有通过。
解决方案：
1）检查报文中的产品号（product_id）是否填写正确;
2）检查报文中的系统号（sys_id）和商户号（huifu_Id） 从属关系是否正确。
更多问题详见斗拱开发者社区：https://service.dougong.net/t/qa
