大額支付

1. 產(chǎn)品介紹

1.1 簡介

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

1.2 應(yīng)用場景

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

樣例待補充

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

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

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

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

1.3 名詞定義及說明

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

手續(xù)費相關(guān)：

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

【手續(xù)費內(nèi)扣】：默認配置，手續(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ī)則：

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

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

2. 接入前準備

2.1 商務(wù)準備

1. 選擇接入模式

2. 直簽?zāi)Ｊ剑褐干虘襞c匯付直接簽約。具體流程：商戶完成協(xié)議簽署后，商戶需要準備好入網(wǎng)材料提供給匯付銷售人員，匯付收到后會盡快為商戶發(fā)起入網(wǎng)申請，待審核通過入網(wǎng)成功后，商戶聯(lián)系人將收到短信通知控臺賬號及密碼。

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

4. 在斗拱完成商戶進件入網(wǎng)

5. 直簽?zāi)Ｊ剑阂延袇R付銷售人員申請開通，商戶無須另行操作；

6. 服務(wù)商模式：

   1. 控臺入網(wǎng)：參考服務(wù)商控臺進件流程，渠道商接入指引；
   2. API入網(wǎng)：企業(yè)商戶調(diào)用企業(yè)商戶基本信息入駐接口 、小微商戶調(diào)用個人商戶基本信息入駐接口 完成開戶、綁卡、結(jié)算配置。

7. 選擇接入功能并準備相關(guān)材料

   1. 大額轉(zhuǎn)賬能力：
      1. 直簽?zāi)Ｊ剑郝?lián)系匯付銷售人員申請開通，商戶無須另行操作；
      2. 服務(wù)商模式：聯(lián)系匯付銷售人員申請開通服務(wù)商大額轉(zhuǎn)賬權(quán)限，開通后給予所屬商戶開通相關(guān)權(quán)限；

2.2 對接準備

第一步：密鑰獲取

聯(lián)調(diào)之前需要先獲取公私鑰，參見公私解鑰參數(shù)獲取說明；

第二步：公共參數(shù)獲取

登錄服務(wù)商/商戶控臺后，可在開發(fā)設(shè)置-開發(fā)者信息中，獲取sys_id，product_id參數(shù)信息;

第三步：業(yè)務(wù)開通及配置

直簽商戶聯(lián)系銷售即可；

• 服務(wù)商或代理商開通

服務(wù)商或代理商通過線下簽約方式申請銀行大額轉(zhuǎn)賬功能；

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

•  商戶開通

1. 開通方式

服務(wù)商控臺開通：服務(wù)商或代理商通過控臺為商戶開通網(wǎng)銀轉(zhuǎn)賬功能權(quán)限；

1. 服務(wù)商通過服務(wù)商控臺為商戶申請

服務(wù)商通過服務(wù)商控臺為商戶申請銀行大額轉(zhuǎn)賬功能

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

在填寫好商戶基礎(chǔ)信息之后，可以選擇開通銀行大額轉(zhuǎn)賬，并填寫相關(guān)費率；

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

入駐狀態(tài)可以在“服務(wù)商控臺-商戶管理-業(yè)務(wù)管理-申請單管理”頁面查詢；

2）通過接口開通

調(diào)用 商戶業(yè)務(wù)開通 接口開通。具體流程請參考API文檔，商戶進件。

3. 開發(fā)指引

3.1 對接規(guī)范

調(diào)用匯付接口，均采取POST形式提交，數(shù)據(jù)格式統(tǒng)一為JSON格式，相關(guān)SDK及簽名方法見鏈接：

SDK示例：Java SDK

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

3.2 確認業(yè)務(wù)配置

登錄控臺查詢大額轉(zhuǎn)賬是否配置完成

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

2. 通過商戶控臺：商戶控臺-【我的信息管理】-【我的信息】-業(yè)務(wù)信息

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

3.3 系統(tǒng)調(diào)用流程

3.3.1 交易流程

銀行大額轉(zhuǎn)賬流程說明

1) 調(diào)用銀行大額轉(zhuǎn)賬接口，創(chuàng)建訂單，匯付返回入賬標識；

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

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

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

行號：991290000099

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

戶號：215500687

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

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

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

圖例：

銀行大額轉(zhuǎn)賬接口需關(guān)注以下字段：

3.3.2 交易關(guān)單

• 商戶自查發(fā)現(xiàn)打款金額或入賬標識錯誤時，可調(diào)用關(guān)單接口進行關(guān)單，并通過企業(yè)微信、郵件等方式聯(lián)系售后經(jīng)理、匯付運營，進行人工退款；

• 如果2個工作日未完成銀行打款，系統(tǒng)會自動關(guān)單；

3.3.3 資金流水查詢

一般情況，商戶通過網(wǎng)銀或線下柜臺轉(zhuǎn)賬成功后，2小時入賬成功，如果超過兩小時未收到異步推送交易結(jié)果，商戶可調(diào)用資金流水查詢接口進行查詢?nèi)胭~情況。

3.3.4 對賬流程

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

方案一：控臺下載；

方案二：接口獲取；參見交易結(jié)算對賬單查詢接口

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

3.3.5 異步通知

針對交易結(jié)果，匯付會通過異步消息的方式通知客戶系統(tǒng)。 

調(diào)用匯付接口時上送的異步通知地址為http/https路徑：服務(wù)器為POST回調(diào)，默認超時時間為5秒，超時后會重試3次；不支持HTTP重定向；服務(wù)器對應(yīng)答不是200~300之間的錯誤，會默認重試3次；異步通知服務(wù)器對HTTPS不認證驗簽和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é)，通過反查接口確認 非終態(tài) 支付訂單的狀態(tài)，以保證在發(fā)生異步消息延遲或無法送達情況下的支付結(jié)果一致性。

詳見異步通知使用說明。

3.4 支持銀行清單

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

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

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

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

【工商銀行】【農(nóng)業(yè)銀行】【交通銀行】【招商銀行】【中信銀行】 【建設(shè)銀行】【江蘇銀行】【中國銀行】【民生銀行】【華夏銀行】 【郵政儲蓄銀行】【浦發(fā)銀行】【東莞農(nóng)村商業(yè)銀行】【浙江泰隆商業(yè)銀行】

4. API列表

5.常見問題

1. 支付接口調(diào)用報錯：“resp_desc”：“數(shù)據(jù)權(quán)限認證失敗”

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

解決方案：

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

2）檢查報文中的系統(tǒng)號（sys_id）和商戶號（huifu_Id） 從屬關(guān)系是否正確。

2. 轉(zhuǎn)賬交易完成，但是未正常入賬。

問題原因：

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

2）交易被風(fēng)控

解決方案：

聯(lián)系售后經(jīng)理、匯付運營，進行人工處置。

更多問題詳見斗拱開發(fā)者社區(qū)：https://service.dougong.net/t/qa