快捷支付

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

1. 產(chǎn)品介紹

1.1 簡(jiǎn)介

持卡人無(wú)需登錄網(wǎng)上銀行，可直接輸入卡面信息及持卡人身份信息。根據(jù)安全規(guī)則通過(guò)驗(yàn)證銀行預(yù)留的手機(jī)接收校驗(yàn)碼完成簽約或支付，是一種便捷、快速、安全的付款方式，主要用于PC網(wǎng)站或移動(dòng)端銀行卡支付。

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

商戶如果想在自己的業(yè)務(wù)場(chǎng)景中擺脫對(duì)微信、支付寶的依賴，獲取用戶信息以便提供更好的服務(wù)可以選擇快捷?；蛘邔⒖旖萆疃热诤系阶约旱臉I(yè)務(wù)場(chǎng)景中，比如整合自己的積分、營(yíng)銷服務(wù)等，可以選擇快捷。斗拱提供了兩種接口模式：

• 純接口模式：包括綁卡、短信預(yù)校驗(yàn)、支付申請(qǐng)、支付確認(rèn)等一系列接口，可以靈活地打造操作流程整合進(jìn)業(yè)務(wù)流程中。
• 帶頁(yè)面的快捷接口，一個(gè)接口拉起支付頁(yè)面完成整個(gè)支付流程，簡(jiǎn)單方便。

可以通過(guò)斗拱演示體驗(yàn)了解快捷支付在PC網(wǎng)站、APP、H5頁(yè)面中的效果。

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

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

1. 選擇接入模式

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

4. 客戶要準(zhǔn)備好線上業(yè)務(wù)場(chǎng)景，快捷支付可以集成到PC網(wǎng)站、APP、H5頁(yè)面的線上場(chǎng)景中。

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

   1. 直簽?zāi)Ｊ剑阂延袇R付銷售人員申請(qǐng)開(kāi)通，商戶無(wú)須另行操作；
   2. 服務(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é)算配置。

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

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

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)未展示，請(qǐng)聯(lián)系對(duì)接群內(nèi)匯付技術(shù)助手提供）

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

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

• 控臺(tái)開(kāi)通

服務(wù)商控臺(tái)【商戶管理】【信息查詢】【商戶信息（新）】【業(yè)務(wù)信息編輯】【支付功能】開(kāi)通快捷支付、配置相關(guān)費(fèi)率

• 接口開(kāi)通

調(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)查詢快捷支付是否配置完成

1. 通過(guò)服務(wù)商控臺(tái)【商戶信息查詢】【產(chǎn)品信息TAB頁(yè)面】查看【快捷】

2. 商戶控臺(tái)【我的信息】

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

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

3.3.1 交易流程

• 頁(yè)面模式：調(diào)用快捷支付頁(yè)面版接口，由于流程已封裝不再描述；可進(jìn)行斗拱演示體驗(yàn)，了解快捷支付在PC網(wǎng)站、APP、H5頁(yè)面中的效果。
• 純接口模式：

由于商戶業(yè)務(wù)場(chǎng)景的差異，上圖描述的只是快捷的標(biāo)準(zhǔn)流程，具體流程商戶在不變更操作順序的情形下可以結(jié)合實(shí)際調(diào)整。

接入步驟說(shuō)明：

1. 快捷支付前需要用戶先完成綁卡，綁卡流程如下：
   1. 用戶輸入個(gè)人信息與卡信息；
   2. 商戶調(diào)用【快捷綁卡申請(qǐng)】接口，會(huì)自動(dòng)發(fā)送短信驗(yàn)證碼給用戶；
   3. 用戶在商戶系統(tǒng)頁(yè)面端輸入驗(yàn)證碼；
   4. 商戶調(diào)用【快捷綁卡確認(rèn)】接口；
   5. 綁卡成功可以獲得綁卡序列號(hào)(token_no)，后續(xù)調(diào)用【快捷支付申請(qǐng)】接口填寫(xiě)到綁卡ID（card_bind_id）字段中。
2. 快捷支付流程分為兩階段；
   1. 用戶選擇一張銀行卡進(jìn)行支付；
   2. 商戶調(diào)用【快捷支付申請(qǐng)】接口，系統(tǒng)會(huì)自動(dòng)發(fā)送驗(yàn)證短信給用戶；
   3. 用戶在商戶系統(tǒng)頁(yè)面端輸入驗(yàn)證碼；
   4. 商戶調(diào)用【快捷支付確認(rèn)】接口完成驗(yàn)證與支付；
3. 商戶會(huì)跳到業(yè)務(wù)系統(tǒng)頁(yè)面。

快捷綁卡申請(qǐng)接口

入?yún)⑿桕P(guān)注以下字段：

快捷綁卡確認(rèn)接口

入?yún)⑿桕P(guān)注以下字段：

返參需關(guān)注字段：

快捷支付申請(qǐng)

入?yún)⑿桕P(guān)注以下字段：

返參需關(guān)注字段：

快捷支付確認(rèn)

入?yún)⑿桕P(guān)注以下字段：

異步返回關(guān)注以下字段：

3.3.2 退款流程

完整的交易流程還要包括退款。由于用戶或者商戶的原因需要退款時(shí)，商戶可以通過(guò)本接口將支付款退還給用戶，退款成功資金將原路返回。

參見(jiàn)線上交易退款接口；

關(guān)注以下請(qǐng)參：

• 原交易請(qǐng)求流水號(hào)、原交易全局流水號(hào)、原交易微信支付寶的商戶單號(hào)三選一即可；
• 退款金額不能大于交易金額；由于接口支持多次部分退款，多次退款場(chǎng)景下退款總額不能高于原交易金額；
• 退款也是以異步返回的成功或失敗狀態(tài)為最終結(jié)果；
• 一些特殊場(chǎng)景下退款時(shí)效可能比較長(zhǎng)，注意接口描述文檔中的退款時(shí)效說(shuō)明；

3.3.3 對(duì)賬流程

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

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

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

• 接口下載的對(duì)賬文件包括以下四類：
  • 日對(duì)賬單類型：包括日結(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. 【快捷綁卡申請(qǐng)】接口報(bào)錯(cuò)：“resp_code”：“00000003”，“resp_desc”：“已超過(guò)最大查詢次數(shù)或操作過(guò)于頻繁”

快捷綁卡要素驗(yàn)證，連續(xù)失敗 3 次以上。

解決方案

核實(shí)要素確實(shí)沒(méi)有問(wèn)題，可 24 小時(shí)后再發(fā)起重試。

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

問(wèn)題原因：商戶信息校驗(yàn)沒(méi)有通過(guò)。

解決方案：

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

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

3. 為什么交易成功以后會(huì)收到 2 條異步通知？

2條異步通知分別是 交易異步 跟 賬務(wù)異步，用 notify_type 字段區(qū)分。

1). 交易異步情況

notify_type='1'，trans_stat='F' 時(shí)，不推送賬務(wù)異步

notify_type='1'，trans_stat='S' 時(shí)，會(huì)推送賬務(wù)異步

2). 賬務(wù)異步情況：

notify_type='2'，trans_stat='S'，acct_stat='S' 表示交易成功-入賬成功

notify_type='2'，trans_stat='S'，acct_stat='F' 表示交易成功-入賬失?。ǚ钦Ｇ闆r，可聯(lián)系匯付技術(shù)人員確認(rèn)排查）

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