大額支付

1. 產品介紹

1.1 簡介

受制于現有掃碼支付、快捷支付、網銀支付的限額，無法滿足客戶的大額支付和充值的需求，提供了銀行大額轉賬的功能。

1.2 應用場景

銀行大額轉賬適用于客戶在移動端和PC端進行大額收款的場景，如供應鏈支付、加油站汽柴油供應采購等這些大額支付場景；

樣例待補充

1：付款人在商戶的APP里選擇訂單進行支付;

2：填寫付款人戶名、卡號后提交至匯付，匯付返回入賬標識；

3：通過付款人銀行APP或到銀行柜臺進行轉賬操作（卡號，戶名，金額，入賬標識（填備注） 四要素要一致）；

4：匯付備份金賬戶收到資金后，系統會自動入賬到商戶，并異步推送入賬信息。

1.3 名詞定義及說明

入賬標識（調賬標識）：我司通過該標識來匹配客戶的大額轉賬交易（該標識我司返回，客戶轉賬時填備注/附言里）

手續費相關：

【實時收取】：默認配置，交易過程中，根據商戶配置的手續費率，實時計算并收取。實時收取模式下可以指定手續費內扣或手續費外扣。

【手續費內扣】：默認配置，手續費內扣指從交易金額中扣收手續費，比如100元的交易金額，0.6%的手續費率，手續費為0.6元。收款方實際收款為100.00-0.6=99.4元。

【手續費外扣】：是從指定的主體及斗拱賬戶中扣收手續費，收款方仍是全額收款。這里指定承擔手續費的主體通常是商戶、平臺、渠道。承擔方及賬戶是在控臺上配置的；需單獨申請開通。

手續費規則：

1. 交易時手續費默認是內扣，如果商戶配置了外扣，可以在調用下單接口時通過【fee_flag】參數指定這筆交易是內扣還是外扣，見【開發指引】-【系統調用流程】-【下單請求支付信息】。
2. 交易手續費，按照四舍五入默認計算，舉例：0.2334，保留兩位小數為0.23元。
3. 退款手續費，全額退款為全額退費。
4. 退款手續費，部分退款公式為：退款手續費（向上取整）=退款金額*原訂單手續費金額/原訂單金額。

【多次退款累計的手續費差額會合并計算到最后一筆退款】，舉例：向上取整為0.011取整為0.02。

2. 接入前準備

2.1 商務準備

1. 選擇接入模式

2. 直簽模式：指商戶與匯付直接簽約。具體流程：商戶完成協議簽署后，商戶需要準備好入網材料提供給匯付銷售人員，匯付收到后會盡快為商戶發起入網申請，待審核通過入網成功后，商戶聯系人將收到短信通知控臺賬號及密碼。

3. 服務商模式：指服務商與匯付簽約，服務商通過接口或控臺方式完成商戶入網。具體流程：服務商完成協議簽署后，服務商需要準備好入網材料提供給匯付銷售人員，匯付收到后會盡快為服務商發起入網申請，待審核通過入網成功后，服務商聯系人將收到短信通知控臺賬號及密碼。

4. 在斗拱完成商戶進件入網

5. 直簽模式：已有匯付銷售人員申請開通，商戶無須另行操作；

6. 服務商模式：

   1. 控臺入網：參考服務商控臺進件流程，渠道商接入指引；
   2. API入網：企業商戶調用企業商戶基本信息入駐接口 、小微商戶調用個人商戶基本信息入駐接口 完成開戶、綁卡、結算配置。

7. 選擇接入功能并準備相關材料

   1. 大額轉賬能力：
      1. 直簽模式：聯系匯付銷售人員申請開通，商戶無須另行操作；
      2. 服務商模式：聯系匯付銷售人員申請開通服務商大額轉賬權限，開通后給予所屬商戶開通相關權限；

2.2 對接準備

第一步：密鑰獲取

聯調之前需要先獲取公私鑰，參見公私解鑰參數獲取說明；

第二步：公共參數獲取

登錄服務商/商戶控臺后，可在開發設置-開發者信息中，獲取sys_id，product_id參數信息;

第三步：業務開通及配置

直簽商戶聯系銷售即可；

• 服務商或代理商開通

服務商或代理商通過線下簽約方式申請銀行大額轉賬功能；

匯付運營人員在審核好服務商資料之后，幫助服務商開通、配置、變更；

•  商戶開通

1. 開通方式

服務商控臺開通：服務商或代理商通過控臺為商戶開通網銀轉賬功能權限；

1. 服務商通過服務商控臺為商戶申請

服務商通過服務商控臺為商戶申請銀行大額轉賬功能

如果是新商戶入駐直接申請銀行大額轉賬，申請路徑：服務商控臺-商戶管理-商戶入駐

在填寫好商戶基礎信息之后，可以選擇開通銀行大額轉賬，并填寫相關費率；

配置好之后，上傳上述要求的資料，保存并提交入駐；

入駐狀態可以在“服務商控臺-商戶管理-業務管理-申請單管理”頁面查詢；

2）通過接口開通

調用 商戶業務開通 接口開通。具體流程請參考API文檔，商戶進件。

3. 開發指引

3.1 對接規范

調用匯付接口，均采取POST形式提交，數據格式統一為JSON格式，相關SDK及簽名方法見鏈接：

SDK示例：Java SDK

加簽驗簽：v2版接口加簽驗簽

3.2 確認業務配置

登錄控臺查詢大額轉賬是否配置完成

1. 通過服務商控臺:服務商控臺-【商戶管理】-【信息查詢】-【商戶信息】-業務信息-編輯-支付功能

2. 通過商戶控臺：商戶控臺-【我的信息管理】-【我的信息】-業務信息

3. 通過商戶詳細信息查詢接口來確認相關配置。

3.3 系統調用流程

3.3.1 交易流程

銀行大額轉賬流程說明

1) 調用銀行大額轉賬接口，創建訂單，匯付返回入賬標識；

2) 客戶通過線上網銀/線下銀行柜臺轉賬，大額轉賬四要素（姓名、卡號、金額、入賬標識（填備注/附言里））務必填寫一致，如不一致請參考3.3.2交易關單流程；

3) 網銀或柜臺匯款到匯付的備付金賬戶，所需信息如下：

行名：上海匯付支付有限公司-備付金賬戶

行號：991290000099

戶名：上海匯付支付有限公司

戶號：215500687

注：各銀行的操作上可能有差異，可能要先選擇“支付公司”類型才能找到行名；

       銀行大小額時間：工作日早8晚5，超過大小額時間，次工作日入賬，具體入賬時間以銀行為準；

4) 匯付收到銀行轉賬信息后，會匹配大額轉賬四要素，一致的做自動入賬，并異步推送入賬信息；

圖例：

銀行大額轉賬接口需關注以下字段：

3.3.2 交易關單

• 商戶自查發現打款金額或入賬標識錯誤時，可調用關單接口進行關單，并通過企業微信、郵件等方式聯系售后經理、匯付運營，進行人工退款；

• 如果2個工作日未完成銀行打款，系統會自動關單；

3.3.3 資金流水查詢

一般情況，商戶通過網銀或線下柜臺轉賬成功后，2小時入賬成功，如果超過兩小時未收到異步推送交易結果，商戶可調用資金流水查詢接口進行查詢入賬情況。

3.3.4 對賬流程

為了滿足商戶財務的對賬需求，斗拱提供了對賬功能。

方案一：控臺下載；

方案二：接口獲??；參見交易結算對賬單查詢接口

• 接口下載的對賬文件包括以下四類：
  • 日對賬單類型：包括日結算對賬單、日分賬對賬單、日出金對賬單；
  • 日交易數據：主要是各種支付交易記錄；
  • 月結算對賬單：按月匯總的結算對賬單；
  • 月交易數據：按月匯總支付交易記錄；

3.3.5 異步通知

針對交易結果，匯付會通過異步消息的方式通知客戶系統。 

調用匯付接口時上送的異步通知地址為http/https路徑：服務器為POST回調，默認超時時間為5秒，超時后會重試3次；不支持HTTP重定向；服務器對應答不是200~300之間的錯誤，會默認重試3次；異步通知服務器對HTTPS不認證驗簽和ALLOW_ALL_HOSTNAME_VERIFIER；如商戶自定義通知端口，請使用8000-9005內端口，否則無法通知；URL 上請勿附帶參數；異步回調請求編碼集為：UTF-8；收到通知后請返回狀態碼“200”,響應異步通知。

注意事項：

同樣的異步消息可能會通知多次，因此接收異步消息的處理需做好冪等，保障多次接收到同樣的消息處理后結果不變。

在實現異步消息接收的同時，都建議您在重要的業務環節，通過反查接口確認 非終態 支付訂單的狀態，以保證在發生異步消息延遲或無法送達情況下的支付結果一致性。

詳見異步通知使用說明。

3.4 支持銀行清單

銀行處理時間為工作日8:00-17:00，超過17:00（建議在16:30前）將在次工作日處理，具體入賬時間以銀行為準。

支持個人大額打款銀行（11家）：

【工商銀行 】【農業銀行】【交通銀行】【招商銀行】【中信銀行（僅支持APP）】 【平安銀行】【江蘇銀行】【中國銀行】【民生銀行】【華夏銀行】 【郵政儲蓄銀行】

支持對公大額打款銀行（14家）：

【工商銀行】【農業銀行】【交通銀行】【招商銀行】【中信銀行】 【建設銀行】【江蘇銀行】【中國銀行】【民生銀行】【華夏銀行】 【郵政儲蓄銀行】【浦發銀行】【東莞農村商業銀行】【浙江泰隆商業銀行】

4. API列表

5.常見問題

1. 支付接口調用報錯：“resp_desc”：“數據權限認證失敗”

問題原因：商戶信息校驗沒有通過。

解決方案：

1）檢查報文中的產品號（product_id）是否填寫正確;

2）檢查報文中的系統號（sys_id）和商戶號（huifu_Id） 從屬關系是否正確。

2. 轉賬交易完成，但是未正常入賬。

問題原因：

1）轉賬時四要素（姓名、卡號、金額、入賬標識）中一項或多項填寫錯誤，導致無法匹配交易

2）交易被風控

解決方案：

聯系售后經理、匯付運營，進行人工處置。

更多問題詳見斗拱開發者社區：https://service.dougong.net/t/qa