銀聯統一在線收銀臺
最近更新時間：2023.10.17
1. 產品介紹
1.1 簡介
商戶開通銀聯統一收銀臺后，消費者在向商戶付款時選擇銀聯，支持消費者在手機端用已安裝的銀行APP完成支付。銀聯會提供旗下多種支付工具，如各銀行APP、云閃付APP、銀聯手機閃付等。
銀聯線上統一收銀臺支持銀行
1.2 應用場景
- 主要用于線上交易場景，如電商購物、旅游平臺等
可以下載斗拱演示APP了解銀聯統一收銀臺的效果。
2. 接入前準備
2.1 商務準備
-
選擇接入模式
-
直簽模式：指商戶與匯付直接簽約。具體流程：商戶完成協議簽署后，商戶需要準備好入網材料提供給匯付銷售人員，匯付收到后會盡快為商戶發起入網申請，待審核通過入網成功后，商戶聯系人將收到短信通知控臺賬號及密碼。
-
服務商模式：指服務商與匯付簽約，服務商通過接口或控臺方式完成商戶入網。具體流程：服務商完成協議簽署后，服務商需要準備好入網材料提供給匯付銷售人員，匯付收到后會盡快為服務商發起入網申請，待審核通過入網成功后，服務商聯系人將收到短信通知控臺賬號及密碼。
-
客戶要準備好線上業務場景，快捷支付可以集成到APP的線上場景中。
-
在斗拱完成商戶進件入網
- 直簽模式：已有匯付銷售人員申請開通，商戶無須另行操作；
- 服務商模式：
- 控臺入網：參考服務商控臺進件流程，渠道商接入指引；
- API入網：企業商戶調用企業商戶基本信息入駐接口 、小微商戶調用個人商戶基本信息入駐接口 完成開戶、綁卡、結算配置。
-
選擇接入功能并準備相關材料
- 銀聯統一在線收銀臺支付能力：
- 直簽模式：聯系匯付銷售人員申請開通，商戶無須另行操作；
- 服務商模式：聯系匯付銷售人員申請開通服務商銀聯統一在線收銀臺支付權限，開通后給予所屬商戶開通相關權限；
- 銀聯統一在線收銀臺支付能力：
2.2 對接準備
第一步：密鑰獲取
聯調之前需要先獲取公私鑰，參見公私解鑰參數獲取說明；
第二步：公共參數獲取
登錄服務商/商戶控臺后，可在開發設置-開發者信息中，獲取sys_id，product_id參數信息;（如控臺未展示，請聯系對接群內匯付技術助手提供）
3. 開發指引
3.1 對接規范
調用匯付接口，均采取POST形式提交，數據格式統一為JSON格式，相關SDK及簽名方法見鏈接：
SDK示例：Java SDK
加簽驗簽：v2版接口加簽驗簽
3.3 系統調用流程
3.3.1 交易流程
銀聯APP支付Android開發包下載 | iOS開發包下載
銀聯統一在線收銀臺接口
入參需關注以下字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| pay_card_no | 交易銀行卡卡號 | 卡號是密文(公私鑰加解密)； |
| card_number_lock | 卡號鎖定標識 | 1-表示鎖定卡，鎖定指只能用pay_card_no卡號做支付。默認為空-不鎖定； |
| ebank_en_abbr | 直通模式的銀行標識 | 目前支付以下銀行： CCB-中國建設銀行， CNCB-中信銀行， CEB-光大銀行， PAB-平安銀行； |
| front_url | 前端跳轉地址 | 支付成功后跳轉頁面，格式：http或https開頭 |
| notify_url | 異步通知地址 | 交易結果異步通知地址，格式：http或https開頭 |
同步返參需關注字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| union_order_no | 銀聯受理訂單號 | 銀聯受理訂單,銀聯移動支付系統返回該流水號，調用支付控件時使用 示例值：562616342321571143110 |
異返參需關注字段：
| 參數 | 中文名 | 說明 |
|---|---|---|
| union_order_no | 銀聯受理訂單號 | 銀聯受理訂單,銀聯移動支付系統返回該流水號，調用支付控件時使用 示例值：562616342321571143110 |
| trans_status | 交易狀態 | 綁卡狀態，I:初始化,P:處理中,S:成功,F:失敗 |
| bank_code | 銀行返回碼 | N |
| bank_message | 銀行返回信息 | 示例值：成功[0000000] |
3.3.2 退款流程
完整的交易流程還要包括退款。由于用戶或者商戶的原因需要退款時，商戶可以通過本接口將支付款退還給用戶，退款成功資金將原路返回。
參見線上交易退款接口；
關注以下請參：
| 參數 | 中文名 | 必填 | 說明 |
|---|---|---|---|
| org_req_date | 原交易請求日期 | Y | 用戶發起支付的日期 |
| org_req_seq_id | 原交易請求流水號 | C | 商戶系統發給斗拱的指令流水號 |
| org_hf_seq_id | 原交易全局流水號 | C | 匯付生成的系統流水號 |
| ord_amt | 申請退款金額 | Y | 退款金額<=原交易金額 |
- 原交易請求流水號、原交易全局流水號、原交易微信支付寶的商戶單號三選一即可；
- 退款金額不能大于交易金額；由于接口支持多次部分退款，多次退款場景下退款總額不能高于原交易金額；
- 退款也是以異步返回的成功或失敗狀態為最終結果；
- 一些特殊場景下退款時效可能比較長，注意接口描述文檔中的退款時效說明；
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列表
| 類型 | 功能 | 描述 |
|---|---|---|
| 應用程序接口 | 銀聯統一在線收銀臺 | 銀聯統一在線收銀臺接口 |
| 應用程序接口 | 線上交易查詢接口 | 查詢單筆線上交易狀態及明細 |
| 應用程序接口 | 線上交易退款接口 | 支持線上交易全額或部分退款 營銷補貼退款：支持全額退款、銀行卡退款，不支持單獨退補貼金額 |
| 應用程序接口 | 線上退款查詢接口 | 查詢單筆線上退款狀態及明細 |
