墊資退款
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
