銀聯(lián)統(tǒng)一在線收銀臺(tái)

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

1. 產(chǎn)品介紹

1.1 簡(jiǎn)介

商戶開(kāi)通銀聯(lián)統(tǒng)一收銀臺(tái)后，消費(fèi)者在向商戶付款時(shí)選擇銀聯(lián)，支持消費(fèi)者在手機(jī)端用已安裝的銀行APP完成支付。銀聯(lián)會(huì)提供旗下多種支付工具，如各銀行APP、云閃付APP、銀聯(lián)手機(jī)閃付等。
銀聯(lián)線上統(tǒng)一收銀臺(tái)支持銀行

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

• 主要用于線上交易場(chǎng)景，如電商購(gòu)物、旅游平臺(tái)等

可以下載斗拱演示APP了解銀聯(lián)統(tǒng)一收銀臺(tái)的效果。

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)景，快捷支付可以集成到APP的線上場(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. 銀聯(lián)統(tǒng)一在線收銀臺(tái)支付能力：
      1. 直簽?zāi)Ｊ剑郝?lián)系匯付銷售人員申請(qǐng)開(kāi)通，商戶無(wú)須另行操作；
      2. 服務(wù)商模式：聯(lián)系匯付銷售人員申請(qǐng)開(kāi)通服務(wù)商銀聯(lián)統(tǒng)一在線收銀臺(tái)支付權(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ù)助手提供）

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.3 系統(tǒng)調(diào)用流程

3.3.1 交易流程

銀聯(lián)APP支付Android開(kāi)發(fā)包下載 | iOS開(kāi)發(fā)包下載

銀聯(lián)統(tǒng)一在線收銀臺(tái)接口

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

同步返參需關(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)題