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