墊資退款
1. 產(chǎn)品介紹
1.1 簡介
1、電商平臺場景下經(jīng)常會有全額退款的需求。由于存在平臺分傭，全額退款需要平臺退分傭。有些情況 下平臺不愿退還分傭就要求商戶墊分傭部分，商戶如果愿意就需要?拱系統(tǒng)?持商戶墊資退款。
2、商戶基本戶資金受監(jiān)管每日交易額需結(jié)算監(jiān)管戶，導(dǎo)致賬戶在沒有新入賬的情況下無資金用于歷史交易的退款，商戶可指定充值戶為墊資退款賬戶，用于退款。
1.2 應(yīng)用場景
實時退款場景
退款時：
1、服務(wù)費資?先從商戶基本戶轉(zhuǎn)到平臺基本戶，實現(xiàn)商戶墊資；
2、再發(fā)起標(biāo)準(zhǔn)退款；
延遲交易未確認(rèn)場景
由于所有收款資?還在延遲戶，所以錢直接從延遲戶退了。
延遲交易確認(rèn)場景
商戶延遲交易流程走完，資金入基本戶。此時退款調(diào)【交易確認(rèn)退款接口】，商戶可以指定：
標(biāo)準(zhǔn)流程：從各自基本戶出款；
墊資流程：從商戶基本戶轉(zhuǎn)賬到平臺基本戶再走標(biāo)準(zhǔn)退款流程；
1.3 名詞定義及說明
手續(xù)費相關(guān)：
【實時收取】：默認(rèn)配置，交易過程中，根據(jù)商戶配置的手續(xù)費率，實時計算并收取。實時收取模式下可以指定手續(xù)費內(nèi)扣或手續(xù)費外扣。
【手續(xù)費內(nèi)扣】：默認(rèn)配置，手續(xù)費內(nèi)扣指從交易金額中扣收手續(xù)費，比如100元的交易金額，0.6%的手續(xù)費率，手續(xù)費為0.6元。收款方實際收款為100.00-0.6=99.4元。
【手續(xù)費外扣】：是從指定的主體及斗拱賬戶中扣收手續(xù)費，收款方仍是全額收款。這里指定承擔(dān)手續(xù)費的主體通常是商戶、平臺、渠道。承擔(dān)方及賬戶是在控臺上配置的；需單獨申請開通；
手續(xù)費規(guī)則：
- 交易時手續(xù)費默認(rèn)是內(nèi)扣，如果商戶配置了外扣，可以在調(diào)用下單接口時通過【fee_flag】參數(shù)指定這筆交易是內(nèi)扣還是外扣，見【開發(fā)指引】-【系統(tǒng)調(diào)用流程】-【下單請求支付信息】。
- 交易手續(xù)費，按照四舍五入默認(rèn)計算，舉例：0.2334，保留兩位小數(shù)為0.23元。
- 退款手續(xù)費，全額退款為全額退費。
- 退款手續(xù)費，部分退款公式為：退款手續(xù)費（向上取整）=退款金額*原訂單手續(xù)費金額/原訂單金額。
【多次退款累計的手續(xù)費差額會合并計算到最后一筆退款】，舉例：向上取整為0.011取整為0.02。
2. 接入前準(zhǔn)備
2.1 商務(wù)準(zhǔn)備
-
選擇接入模式
-
直簽?zāi)Ｊ剑褐干虘襞c匯付直接簽約。具體流程：商戶完成協(xié)議簽署后，商戶需要準(zhǔn)備好入網(wǎng)材料提供給匯付銷售人員，匯付收到后會盡快為商戶發(fā)起入網(wǎng)申請，待審核通過入網(wǎng)成功后，商戶聯(lián)系人將收到短信通知控臺賬號及密碼。
-
服務(wù)商模式：指服務(wù)商與匯付簽約，服務(wù)商通過接口或控臺方式完成商戶入網(wǎng)。具體流程：服務(wù)商完成協(xié)議簽署后，服務(wù)商需要準(zhǔn)備好入網(wǎng)材料提供給匯付銷售人員，匯付收到后會盡快為服務(wù)商發(fā)起入網(wǎng)申請，待審核通過入網(wǎng)成功后，服務(wù)商聯(lián)系人將收到短信通知控臺賬號及密碼。
-
在斗拱完成商戶進(jìn)件入網(wǎng)
- 直簽?zāi)Ｊ剑阂延袇R付銷售人員申請開通，商戶無須另行操作；
- 服務(wù)商模式：
- 控臺入網(wǎng)：參考服務(wù)商控臺進(jìn)件流程，渠道商接入指引http://paas.huifu.com；
- API入網(wǎng)：企業(yè)商戶調(diào)用 企業(yè)商戶基本信息入駐接口 、小微商戶調(diào)用 個人商戶基本信息入駐接口 完成開戶、綁卡、結(jié)算配置。
2.2 對接準(zhǔn)備
第一步：密鑰獲取
聯(lián)調(diào)之前需要先獲取公私鑰，參見公私解鑰參數(shù)獲取說明；
第二步：公共參數(shù)獲取
登錄服務(wù)商/商戶控臺后，可在開發(fā)設(shè)置-開發(fā)者信息中，獲取sys_id，product_id參數(shù)信息；（如控臺未展示，請聯(lián)系對接群內(nèi)匯付技術(shù)助手提供）
第三步：業(yè)務(wù)開通及配置
1： 渠道商控臺為商戶開通“退款墊資功能”
2： 商戶登錄控臺在【賬戶管理】【賬戶管理】菜單下創(chuàng)建一個充值戶，并為充值戶開通退款墊資功能；
接口暫不支持開通。
3. 開發(fā)指引
3.1 對接規(guī)范
調(diào)用匯付接口，均采取POST形式提交，數(shù)據(jù)格式統(tǒng)一為JSON格式，相關(guān)SDK及簽名方法見鏈接：
SDK示例：Java SDKhttp://paas.huifu.com
加簽驗簽：v2版接口加簽驗簽http://paas.huifu.com
3.2 系統(tǒng)調(diào)用流程
3.2.1 退款流程
調(diào)【掃碼交易退款】、【交易確認(rèn)退款】接?時，
傳?參數(shù)指定退款類型為墊資退款、墊資 ?、墊資賬戶類型；
關(guān)注以下請參：
| 參數(shù) | 中文名 | 必填 | 說明 |
|---|---|---|---|
| loan_flag | 是否墊資退款 | N | Y 是墊資出款， N 是普通出款， 為空默認(rèn)N；示例值：N |
| loan_undertaker | 墊資承擔(dān)者 | N | 墊資方的huifu_id；為空: 各自承擔(dān)。不為空走第三方墊資。 目前支持商戶墊資。墊資方一定參與了交易分賬，否則不支持墊資。 |
| loan_acct_type | 墊資賬戶類型 | N | 01:基本戶, 05: 充值戶, 默認(rèn)充值戶；示例值：05 |
3.2.2 異步通知
針對交易結(jié)果，匯付會通過異步消息的方式通知客戶系統(tǒng)。
調(diào)用匯付接口時上送的異步通知地址為http/https路徑：服務(wù)器為POST回調(diào)，默認(rèn)超時時間為5秒，超時后會重試3次；不支持HTTP重定向；服務(wù)器對應(yīng)答不是200~300之間的錯誤，會默認(rèn)重試3次；異步通知服務(wù)器對HTTPS不認(rèn)證驗簽和ALLOW_ALL_HOSTNAME_VERIFIER；如商戶自定義通知端口，請使用8000-9005內(nèi)端口，否則無法通知；URL 上請勿附帶參數(shù)；異步回調(diào)請求編碼集為：UTF-8；收到通知后請返回狀態(tài)碼“200”,響應(yīng)異步通知。
注意事項：
同樣的異步消息可能會通知多次，因此接收異步消息的處理需做好冪等，保障多次接收到同樣的消息處理后結(jié)果不變。
在實現(xiàn)異步消息接收的同時，都建議您在重要的業(yè)務(wù)環(huán)節(jié)，通過反查接口確認(rèn) 非終態(tài) 支付訂單的狀態(tài)，以保證在發(fā)生異步消息延遲或無法送達(dá)情況下的支付結(jié)果一致性。
詳見異步通知使用說明。
4. API列表
| 類型 | 功能 | 描述 |
|---|---|---|
| 應(yīng)用程序接口 | 掃碼交易退款 | 本接口將支付款退還給用戶，退款成功資金將原路返回 |
| 應(yīng)用程序接口 | 交易確認(rèn)退款 | 本接口將已確認(rèn)的訂單金額退回至原商戶賬戶。 |
5.常見問題
- 支付接口調(diào)用報錯：“resp_desc”：“數(shù)據(jù)權(quán)限認(rèn)證失敗”
問題原因：商戶信息校驗沒有通過。
解決方案：
1）檢查報文中的產(chǎn)品號（product_id）是否填寫正確;
2）檢查報文中的系統(tǒng)號（sys_id）和商戶號（huifu_Id） 從屬關(guān)系是否正確。
更多問題詳見斗拱開發(fā)者社區(qū)：https://service.dougong.net/t/qa
