網(wǎng)銀支付

最近更新時(shí)間：2023.11.20

1. 產(chǎn)品介紹

1.1 簡(jiǎn)介

網(wǎng)銀支付主要適用于企業(yè)用戶和個(gè)人用戶在商戶頁(yè)面進(jìn)行B2B或B2C支付的場(chǎng)景。企業(yè)用戶或個(gè)人用戶在商戶頁(yè)面通過(guò)點(diǎn)擊支付圖標(biāo)，然后跳轉(zhuǎn)到匯付網(wǎng)銀支付銀行選擇頁(yè)面點(diǎn)擊相應(yīng)銀行圖標(biāo)，或直接在商戶頁(yè)面點(diǎn)擊相應(yīng)銀行的網(wǎng)銀圖標(biāo)，跳轉(zhuǎn)至賬戶發(fā)行方網(wǎng)銀頁(yè)面后，進(jìn)行付款操作，完成支付。

1.2 應(yīng)用場(chǎng)景

該產(chǎn)品主要應(yīng)用于境內(nèi)商戶的企業(yè)線上B2B交易和個(gè)人B2C支付，適用場(chǎng)景包括電子商務(wù)、行業(yè)供應(yīng)鏈、企業(yè)采購(gòu)、招投標(biāo)支付、公共服務(wù)支付、物流保險(xiǎn)等領(lǐng)域。

樣例

a) 付款人瀏覽商戶購(gòu)物網(wǎng)站，選擇商品；

b) 付款人在商戶購(gòu)物網(wǎng)站確認(rèn)商品，并提交訂單；

c) 付款人在銀行列表選擇所要支付的銀行（如果是企業(yè)，則在企業(yè)網(wǎng)銀銀行列表頁(yè)面選擇所要支付的銀行，企業(yè)網(wǎng)銀支付有經(jīng)辦和復(fù)核兩個(gè)環(huán)節(jié)）；

d) 付款人在銀行頁(yè)面完成支付；

注：付款人的銀行卡需要預(yù)先在銀行網(wǎng)銀或柜面開(kāi)通網(wǎng)銀支付功能可進(jìn)行支付。

可進(jìn)行斗拱演示體驗(yàn)，了解網(wǎng)銀支付的效果。

2. 接入前準(zhǔn)備

2.1 商務(wù)準(zhǔn)備

1. 選擇接入模式

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

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

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

5. 直簽?zāi)Ｊ剑阂延袇R付銷(xiāo)售人員申請(qǐng)開(kāi)通，商戶無(wú)須另行操作；

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

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

2.2 對(duì)接準(zhǔn)備

第一步：密鑰獲取

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

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

登錄服務(wù)商/商戶控臺(tái)后，可在開(kāi)發(fā)設(shè)置-開(kāi)發(fā)者信息中，獲取sys_id，product_id參數(shù)信息（如控臺(tái)未展示，可群內(nèi)咨詢匯付技術(shù)人員獲?。?

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

• 服務(wù)商/代理商開(kāi)通

服務(wù)商或代理商通過(guò)線下簽約方式申請(qǐng)網(wǎng)銀功能；

運(yùn)營(yíng)人員在審核好服務(wù)商資料之后，為服務(wù)商開(kāi)通網(wǎng)銀支付功能，及費(fèi)率配置；

•  商戶開(kāi)通

可以通過(guò)服務(wù)商控臺(tái)和接口兩種方式為商戶開(kāi)通網(wǎng)銀支付功能權(quán)限；

1. 通過(guò)服務(wù)商控臺(tái)申請(qǐng)

服務(wù)商通過(guò)服務(wù)商控臺(tái)為商戶申請(qǐng)網(wǎng)銀支付功能

服務(wù)商控臺(tái)-商戶管理-商戶信息-操作“查看”-業(yè)務(wù)信息“編輯”-支付功能

第一步，在商戶信息頁(yè)面點(diǎn)擊“查詢”，在下方列表這種選擇要開(kāi)通功能的商戶，點(diǎn)擊“查看”，進(jìn)入功能查看和申請(qǐng)頁(yè)面；

第二步，在“商戶詳情”頁(yè)面點(diǎn)擊“編輯”，進(jìn)入“業(yè)務(wù)信息編輯”頁(yè)面；

第三步，在“業(yè)務(wù)信息編輯”頁(yè)面在“支付功能”選擇開(kāi)通“網(wǎng)銀支付”，申請(qǐng)開(kāi)通時(shí)需要配置商戶的B2C（個(gè)人網(wǎng)銀）貸記卡、B2C（個(gè)人網(wǎng)銀）借記卡和B2B（企業(yè)網(wǎng)銀）的費(fèi)率，并選擇“商戶業(yè)務(wù)類(lèi)型”，每個(gè)業(yè)務(wù)類(lèi)型對(duì)應(yīng)的申請(qǐng)材料各不相同，詳見(jiàn)2.2.1申請(qǐng)資料章節(jié)，并提交資料，點(diǎn)擊“確定提交”就可進(jìn)入?yún)R付功能審核環(huán)節(jié)，匯付運(yùn)營(yíng)人員在4個(gè)小時(shí)內(nèi)審核完成；

2. 通過(guò)接口申請(qǐng)

調(diào)用 商戶業(yè)務(wù)開(kāi)通 接口開(kāi)通。具體流程請(qǐng)參考API文檔，商戶進(jìn)件。

3. 開(kāi)發(fā)指引

3.1 對(duì)接規(guī)范

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

SDK示例：Java SDK

加簽驗(yàn)簽：v2版接口加簽驗(yàn)簽

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

登錄控臺(tái)查詢商戶網(wǎng)銀支付是否配置完成

1. 服務(wù)商控臺(tái)-【商戶管理】-【商戶信息】-操作“查看”-支付功能

   

2. 商戶控臺(tái)-【我的信息管理】-【我的信息】-業(yè)務(wù)信息

3. 通過(guò)商戶詳細(xì)信息查詢接口來(lái)確認(rèn)相關(guān)配置。

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

3.3.1 交易流程

商戶調(diào)用網(wǎng)銀流程說(shuō)明

商戶可根據(jù)需求自由選擇支付模式：

• 模式一：調(diào)接口展示斗拱的銀行選擇頁(yè)面，展示商戶在控臺(tái)配置好的所有銀行，客戶選完銀行后展示銀行網(wǎng)銀頁(yè)面。
• 模式二：調(diào)接口時(shí)指定銀行，斗拱頁(yè)面只顯示指定的銀行，用戶按要求通過(guò)指定銀行支付。

兩種模式可通過(guò)網(wǎng)銀支付接口的bank_id(付款方銀行編號(hào))區(qū)分，不上送bank_id代表模式一，商戶獲取斗拱平臺(tái)的銀行選擇頁(yè)面html；上送bank_id代表模式二，商戶獲取指定的銀行網(wǎng)銀頁(yè)面html。

接入步驟：

a) 商戶調(diào)用網(wǎng)銀支付接口，提交訂單：

b) 客戶選擇對(duì)應(yīng)銀行，喚起銀行網(wǎng)銀支付頁(yè)面；

c) 客戶完成支付操作；

d) 銀行系統(tǒng)會(huì)異步通知匯付支付狀態(tài)；

e) 匯付異步通知商戶支付狀態(tài)；

查詢

a) 商戶調(diào)用線上交易查詢接口，上傳原交易日期、原交易訂單號(hào)等信息查詢?cè)撚唵谓灰捉Y(jié)果；

b) 匯付斗拱系統(tǒng)同步返回該筆網(wǎng)銀支付訂單交易結(jié)果；

網(wǎng)銀支付接口需關(guān)注以下字段：

3.3.2 退款流程

a) 商戶調(diào)用線上交易退款接口，向匯付發(fā)起退款；

b) 匯付判斷商戶收款賬戶中是否資金滿足本次退款金額；

c) 匯付向銀行發(fā)起退款請(qǐng)求；

d) 銀行返回退款請(qǐng)求結(jié)果給到匯付；

e) 匯付同步返回退款請(qǐng)求狀態(tài)給到商戶；

f) 銀行端異步返回退款結(jié)果給到匯付；

g) 匯付異步返回退款結(jié)果給到商戶；

退款查詢：調(diào)用線上退款查詢接口，上傳原退款請(qǐng)求日期、原退款交易流水號(hào)、進(jìn)行退款交易結(jié)果查詢；

3.3.3 對(duì)賬流程

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

方案一：控臺(tái)下載；

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

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

3.3.4 異步通知

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

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

注意事項(xiàng)：

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

在實(shí)現(xiàn)異步消息接收的同時(shí)，都建議您在重要的業(yè)務(wù)環(huán)節(jié)，通過(guò)反查接口確認(rèn) 非終態(tài) 支付訂單的狀態(tài)，以保證在發(fā)生異步消息延遲或無(wú)法送達(dá)情況下的支付結(jié)果一致性。

詳見(jiàn)異步通知使用說(shuō)明。

4. API列表

5.常見(jiàn)問(wèn)題

1.  關(guān)單時(shí)間：商戶傳time_expire 訂單失效時(shí)間（注：工商銀行需傳90min以上方能成功），超過(guò)時(shí)間會(huì)將該筆訂單進(jìn)行失效處理。不傳默認(rèn)5小時(shí)。
2.  瀏覽器兼容性：建議使用IE11及以上系統(tǒng)，Google、火狐瀏覽器，不建議使用包括360、QQ瀏覽器；
3.  限額及支持銀行：詳見(jiàn)支持銀行限額Excel；

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