網銀支付
最近更新時間：2023.11.20
1. 產品介紹
1.1 簡介
網銀支付主要適用于企業用戶和個人用戶在商戶頁面進行B2B或B2C支付的場景。企業用戶或個人用戶在商戶頁面通過點擊支付圖標，然后跳轉到匯付網銀支付銀行選擇頁面點擊相應銀行圖標，或直接在商戶頁面點擊相應銀行的網銀圖標，跳轉至賬戶發行方網銀頁面后，進行付款操作，完成支付。
1.2 應用場景
該產品主要應用于境內商戶的企業線上B2B交易和個人B2C支付，適用場景包括電子商務、行業供應鏈、企業采購、招投標支付、公共服務支付、物流保險等領域。
樣例
a) 付款人瀏覽商戶購物網站，選擇商品；
b) 付款人在商戶購物網站確認商品，并提交訂單；
c) 付款人在銀行列表選擇所要支付的銀行（如果是企業，則在企業網銀銀行列表頁面選擇所要支付的銀行，企業網銀支付有經辦和復核兩個環節）；
d) 付款人在銀行頁面完成支付；
注：付款人的銀行卡需要預先在銀行網銀或柜面開通網銀支付功能可進行支付。
可進行斗拱演示體驗，了解網銀支付的效果。
2. 接入前準備
2.1 商務準備
-
選擇接入模式
-
直簽模式：指商戶與匯付直接簽約。具體流程：商戶完成協議簽署后，商戶需要準備好入網材料提供給匯付銷售人員，匯付收到后會盡快為商戶發起入網申請，待審核通過入網成功后，商戶聯系人將收到短信通知控臺賬號及密碼。
-
服務商模式：指服務商與匯付簽約，服務商通過接口或控臺方式完成商戶入網。具體流程：服務商完成協議簽署后，服務商需要準備好入網材料提供給匯付銷售人員，匯付收到后會盡快為服務商發起入網申請，待審核通過入網成功后，服務商聯系人將收到短信通知控臺賬號及密碼。
-
在斗拱完成商戶進件入網
-
直簽模式：已有匯付銷售人員申請開通，商戶無須另行操作；
-
服務商模式：
- 控臺入網：參考服務商控臺進件流程，渠道商接入指引；
- API入網：企業商戶調用企業商戶基本信息入駐接口 、小微商戶調用個人商戶基本信息入駐接口 完成開戶、綁卡、結算配置。
2.2 對接準備
第一步：密鑰獲取
聯調之前需要先獲取公私鑰，參見公私解鑰參數獲取說明；
第二步：公共參數獲取
登錄服務商/商戶控臺后，可在開發設置-開發者信息中，獲取sys_id，product_id參數信息（如控臺未展示，可群內咨詢匯付技術人員獲取）;
第三步：業務開通及配置
- 服務商/代理商開通
服務商或代理商通過線下簽約方式申請網銀功能；
運營人員在審核好服務商資料之后，為服務商開通網銀支付功能，及費率配置；
- 商戶開通
可以通過服務商控臺和接口兩種方式為商戶開通網銀支付功能權限；
- 通過服務商控臺申請
服務商通過服務商控臺為商戶申請網銀支付功能
服務商控臺-商戶管理-商戶信息-操作“查看”-業務信息“編輯”-支付功能
第一步，在商戶信息頁面點擊“查詢”，在下方列表這種選擇要開通功能的商戶，點擊“查看”，進入功能查看和申請頁面；
第二步，在“商戶詳情”頁面點擊“編輯”，進入“業務信息編輯”頁面；
第三步，在“業務信息編輯”頁面在“支付功能”選擇開通“網銀支付”，申請開通時需要配置商戶的B2C（個人網銀）貸記卡、B2C（個人網銀）借記卡和B2B（企業網銀）的費率，并選擇“商戶業務類型”，每個業務類型對應的申請材料各不相同，詳見2.2.1申請資料章節，并提交資料，點擊“確定提交”就可進入匯付功能審核環節，匯付運營人員在4個小時內審核完成；
- 通過接口申請
調用 商戶業務開通 接口開通。具體流程請參考API文檔，商戶進件。
3. 開發指引
3.1 對接規范
調用匯付接口，均采取POST形式提交，數據格式統一為JSON格式，相關SDK及簽名方法見鏈接：
SDK示例：Java SDK
加簽驗簽：v2版接口加簽驗簽
3.2 確認業務配置
登錄控臺查詢商戶網銀支付是否配置完成
-
服務商控臺-【商戶管理】-【商戶信息】-操作“查看”-支付功能
-
商戶控臺-【我的信息管理】-【我的信息】-業務信息
- 通過商戶詳細信息查詢接口來確認相關配置。
3.3 系統調用流程
3.3.1 交易流程
商戶調用網銀流程說明
商戶可根據需求自由選擇支付模式：
- 模式一：調接口展示斗拱的銀行選擇頁面，展示商戶在控臺配置好的所有銀行，客戶選完銀行后展示銀行網銀頁面。
- 模式二：調接口時指定銀行，斗拱頁面只顯示指定的銀行，用戶按要求通過指定銀行支付。
兩種模式可通過網銀支付接口的bank_id(付款方銀行編號)區分，不上送bank_id代表模式一，商戶獲取斗拱平臺的銀行選擇頁面html；上送bank_id代表模式二，商戶獲取指定的銀行網銀頁面html。
接入步驟：
a) 商戶調用網銀支付接口，提交訂單：
b) 客戶選擇對應銀行，喚起銀行網銀支付頁面；
c) 客戶完成支付操作；
d) 銀行系統會異步通知匯付支付狀態；
e) 匯付異步通知商戶支付狀態；
查詢
a) 商戶調用線上交易查詢接口，上傳原交易日期、原交易訂單號等信息查詢該訂單交易結果；
b) 匯付斗拱系統同步返回該筆網銀支付訂單交易結果；
網銀支付接口需關注以下字段：
| 參數 | 中文名 | 必填 | 說明 |
|---|---|---|---|
| time_expire | 訂單失效時間 | N | 格式yyyyMMddHHmmss；示例值：20221102202234 （注：工商銀行需傳90min以上方能成功）；不傳默認5小時； |
| gate_type | 網關支付類型 | N | 01: 個人網關，02: 企業網關，不傳值，默認：01（個人網關）；示例值：01 |
| bank_id | 付款方銀行編號 | N | 若填入付款方銀行編號時，同步返回具體銀行頁面； 若未填入付款方銀行編號時，同步返回銀行選擇頁面 |
| notify_url | 異步通知地址 | Y | 交易結果異步通知地址，格式以http或https開頭。 示例值：https://callback.service.com/xx |
3.3.2 退款流程
a) 商戶調用線上交易退款接口，向匯付發起退款；
b) 匯付判斷商戶收款賬戶中是否資金滿足本次退款金額；
c) 匯付向銀行發起退款請求；
d) 銀行返回退款請求結果給到匯付；
e) 匯付同步返回退款請求狀態給到商戶；
f) 銀行端異步返回退款結果給到匯付；
g) 匯付異步返回退款結果給到商戶；
退款查詢：調用線上退款查詢接口，上傳原退款請求日期、原退款交易流水號、進行退款交易結果查詢；
3.3.3 對賬流程
為了滿足商戶財務的對賬需求，斗拱提供了對賬功能。
方案一：控臺下載；
方案二：接口獲取；參見交易結算對賬單查詢接口
- 接口下載的對賬文件包括以下四類：
- 日對賬單類型：包括日結算對賬單、日分賬對賬單、日出金對賬單；
- 日交易數據：主要是各種支付交易記錄；
- 月結算對賬單：按月匯總的結算對賬單；
- 月交易數據：按月匯總支付交易記錄；
3.3.4 異步通知
針對交易結果，匯付會通過異步消息的方式通知客戶系統。
調用匯付接口時上送的異步通知地址為http/https路徑：服務器為POST回調，默認超時時間為5秒，超時后會重試3次；不支持HTTP重定向；服務器對應答不是200~300之間的錯誤，會默認重試3次；異步通知服務器對HTTPS不認證驗簽和ALLOW_ALL_HOSTNAME_VERIFIER；如商戶自定義通知端口，請使用8000-9005內端口，否則無法通知；URL 上請勿附帶參數；異步回調請求編碼集為：UTF-8；收到通知后請返回狀態碼“200”,響應異步通知。
注意事項：
同樣的異步消息可能會通知多次，因此接收異步消息的處理需做好冪等，保障多次接收到同樣的消息處理后結果不變。
在實現異步消息接收的同時，都建議您在重要的業務環節，通過反查接口確認 非終態 支付訂單的狀態，以保證在發生異步消息延遲或無法送達情況下的支付結果一致性。
詳見異步通知使用說明。
4. API列表
| 類型 | 功能 | 描述 |
|---|---|---|
| 應用程序接口 | 網銀支付接口 | 支持個人網銀和企業網銀 |
| 應用程序接口 | 網銀支持銀行列表查詢 | 用于商戶網銀支付前查詢支付銀行列表使用 |
| 應用程序接口 | 網銀付款銀行賬戶查詢 | 用于網銀交易支付成功后，商戶需要查詢網銀支付付款銀行卡賬戶信息時使用 |
| 應用程序接口 | 線上交易查詢 | 用于查詢單筆線上交易狀態及明細 |
| 應用程序接口 | 線上交易退款 | 用于查詢線上交易全額或部分退款 |
| 應用程序接口 | 線上交易退款查詢 | 用于查詢單筆線上退款狀態及明細 |
5.常見問題
- 關單時間：商戶傳time_expire 訂單失效時間（注：工商銀行需傳90min以上方能成功），超過時間會將該筆訂單進行失效處理。不傳默認5小時。
- 瀏覽器兼容性：建議使用IE11及以上系統，Google、火狐瀏覽器，不建議使用包括360、QQ瀏覽器；
- 限額及支持銀行：詳見支持銀行限額Excel；
更多問題詳見斗拱開發者社區：https://service.dougong.net/t/qa
