一般網上支付-銀聯在線
專用API
【更新時間: 2024.01.22】
銀聯在線一般網上支付API服務是中國銀聯提供的一種集成化互聯網支付工具,支持多種支付方式。它主要服務于持卡人在商戶PC網站的購物支付場景,用戶點擊支付圖標后跳轉至銀聯頁面完成支付。
咨詢
去服務商官網采購>
|
瀏覽次數
18
采購人數
0
試用次數
0
收藏
×
完成
取消
×
書簽名稱
確定
|
- API詳情
- 使用指南
- 常見 FAQ
- 關于我們
- 相關推薦


什么是銀聯在線的一般網上支付?
銀聯在線-一般網上支付API服務是中國銀聯提供的一種集成化、綜合性的互聯網支付工具。它支持多種支付方式,包括輸入卡號付款、用戶登錄支付、網銀支付、迷你付(IC卡支付)等,為持卡人提供境內外網上購物、水電煤繳費、商旅預訂等支付服務。這項服務主要適用于持卡人在商戶PC網站購物支付場景,用戶可以通過點擊銀聯在線支付圖標,并跳轉至銀聯頁面完成支付信息錄入,最終完成支付。
什么是銀聯在線的一般網上支付接口?
銀聯在線的一般網上支付有哪些核心功能?
- 消費類交易接口:這是基礎的支付接口,允許商戶發起一筆消費交易。商戶需要定義交易請求參數,如商戶編號、訂單號、交易金額等,并在交易成功后接收交易應答參數,如交易狀態、交易流水號等。這個接口通常用于線上購物、服務預訂等場景。
- 后續類交易接口:這類接口用于處理已經發生的交易的后續操作。具體包括:
- 退款:商戶可以因商品退貨或服務取消等原因,通過這個接口將已扣款項歸還給持卡人。支持全額退款和部分退款。
- 退款撤銷:如果退款操作有誤,可以通過退款撤銷接口進行更正。
- 退款重匯:在退款操作后,如果需要重新執行退款,可以使用此接口。
- 消費撤銷:用于撤銷已經完成的消費交易,通常是在當日內的操作。
- 預授權撤銷:對于預授權交易,如果需要取消,可以通過此接口進行撤銷。
- 預授權完成:用于將預授權金額正式劃扣。
- 預授權完成撤銷:如果預授權完成操作有誤,可以通過此接口進行撤銷。
- 通知分賬:在一筆交易完成后,如果需要將資金分配給多個參與方,可以通過此接口實現。
- 交易查詢接口:商戶可以通過這個接口查詢單筆交易的詳細情況,包括交易狀態、交易金額等。這有助于商戶進行賬務核對和客戶服務。
- 交易對賬接口:銀聯會提供交易對賬文件,商戶可以通過這個接口下載對賬文件,進行賬務核對。對賬文件通常包含一定時期內的所有交易記錄,格式會有詳細說明。
- 結算對賬接口:與交易對賬類似,結算對賬接口用于處理結算相關的對賬工作。商戶可以通過這個接口獲取結算文件,確保結算金額的準確性。
銀聯在線的一般網上支付的核心優勢是什么?
- 安全性:銀聯在線支付采用多重安全防控技術,具備強大的風險監控系統,能夠實時攔截可疑交易,確保交易的安全性。此外,系統還具備完備的風險處置和化解機制,維護各方利益。
- 便捷性:持卡人無需開通網銀即可享受網上支付服務,支持多種支付方式,包括輸入卡號付款、用戶登錄支付、網銀支付等,極大地提升了用戶體驗。
- 全球支付:銀聯的跨境網上支付服務覆蓋全球主要國家和地區,持卡人可以使用銀聯卡進行境外網上購物,免收貨幣轉換費,實現“輕點鼠標,網購全球”。
- 金融級擔保交易:銀聯在線支付支持金融級預授權擔保交易,交易資金在持卡人自有賬戶內凍結,避免了提前劃款給第三方的風險,最大化保護了銀行、商戶和持卡人的權益。
- 綜合性商戶服務:銀聯為商戶提供線下線上一體化的資金清算服務和便利的交易管理服務,幫助商戶提高資金管理效率,擴大客戶資源。
- 無門檻支付:銀聯在線支付通過無卡支付通道,讓未開通網銀的客戶也能進行網上支付,吸引更多用戶參與網上交易。
在哪些場景會用到銀聯在線的一般網上支付?
1. 電子商務平臺
在電子商務平臺上,銀聯在線支付API接口為消費者提供了便捷的支付解決方案。用戶在購物時,選擇商品后進入結算頁面,點擊銀聯支付選項,系統會跳轉至銀聯支付頁面。用戶可以通過輸入卡號或掃碼支付完成交易。該接口支持多種支付方式,滿足不同用戶的需求。商戶通過集成銀聯支付接口,能夠快速接入支付功能,提升用戶體驗,同時享受銀聯提供的安全保障,降低交易風險。電子商務平臺如京東、天貓等均已廣泛應用此接口,確保交易的安全性和便捷性。
2. 服務預訂平臺
在酒店和旅游服務預訂平臺,銀聯在線支付API接口為用戶提供了高效的支付體驗。用戶在選擇酒店或旅游產品后,可以直接通過銀聯支付完成預訂。該接口支持預授權功能,商戶可以在用戶預訂時凍結一定金額,確保用戶在入住或出行時不會因支付問題而產生不必要的麻煩。此外,退款和撤銷功能也為用戶提供了更大的靈活性,確保在取消預訂時能夠快速處理退款。像攜程、去哪兒等平臺均利用銀聯支付接口提升用戶的預訂體驗。
3. 公共事業繳費
銀聯在線支付API接口在公共事業繳費中也發揮了重要作用。用戶可以通過各類繳費平臺,方便地支付水電煤等公共事業費用。通過銀聯支付,用戶只需在手機或電腦上輸入相關信息,選擇銀聯支付方式,便可完成繳費。該接口的安全性和便捷性使得用戶無需前往實體繳費點,節省了時間和精力。同時,商戶也能通過銀聯支付接口實現快速結算,提高資金周轉效率。
4. 教育繳費
在教育行業,銀聯在線支付API接口為學校和教育機構提供了便捷的收費方式。家長可以通過學校的在線平臺,直接使用銀聯支付接口繳納學費、考試費等。該接口支持部分退款和多次退款功能,方便家長在需要時進行費用調整。通過銀聯支付,學校能夠快速收款,減少現金管理的復雜性,同時提升家長的支付體驗,確保資金流動的安全和高效。
5. 慈善捐贈
銀聯在線支付API接口也被廣泛應用于慈善機構的捐贈活動中。慈善組織可以通過集成銀聯支付接口,讓捐贈者方便快捷地進行捐款。用戶在捐贈時,可以選擇銀聯支付,快速完成交易。該接口的安全性和便捷性,提升了捐贈者的信任感,鼓勵更多人參與慈善活動。同時,慈善機構也能通過銀聯支付接口實現資金的快速到賬,提升資金使用效率。


消費類交易接口
ChinaPay的網上支付服務采用WEB服務的方式允許商戶接入,接收交易數據的地址為:
Ø 測試環境請求地址:
- 前臺交易URL:
http://newpayment-test.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0
- 后臺交易URL:
http://newpayment-test.chinapay.com/CTITS/service/rest/forward/sta/000000000017/0/0/0/0/0
Ø 生產環境請求地址:
- 前臺交易URL:
https://payment.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0
- 后臺交易URL:
https://payment.chinapay.com/CTITS/service/rest/forward/sta/000000000017/0/0/0/0/0
說明:
走前臺地址的交易:0001個人網銀支付、0002企業網銀支付、0004快捷支付、0005賬單支付、0006認證支付、0007分期付款、0201預授權交易。
走后臺地址的交易:0003授信交易、0008后臺支付。
后續類交易接口
ChinaPay的網上支付服務采用WEB服務的方式允許商戶接入,其中:
l 0401退款、0402退款撤銷、0409退款重匯、9908通知分賬的交易接收地址如下:
Ø 測試環境請求地址:
http://newpayment-test.chinapay.com/CTITS/service/rest/forward/syn/000000000065/0/0/0/0/0
Ø 生產環境請求地址:
https://payment.chinapay.com/CTITS/service/rest/forward/syn/000000000065/0/0/0/0/0
l 0403消費撤銷、0203預授權撤銷、0204預授權完成撤銷、0202預授權完成的交易接收地址如下:
Ø 測試環境請求地址:
http://newpayment-test.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0
Ø 生產環境請求地址:
https://payment.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0
交易查詢接口
ChinaPay的網上支付服務采用WEB服務的方式允許商戶接入,接收交易數據的地址為:
Ø測試環境:
http://newpayment-test.chinapay.com/CTITS/service/rest/forward/syn/000000000060/0/0/0/0/0
Ø生產環境:
https://payment.chinapay.com/CTITS/service/rest/forward/syn/000000000060/0/0/0/0/0
交易對賬接口
對于已經提交給ChinaPay平臺的交易,ChinaPay會在第二天生成商戶對賬文件,包括T-1日商戶所有的交易(其中退款交易為商戶已審核通過的退款明細),以供商戶對賬使用。對賬文件生成后,ChinaPay后臺通知商戶下載或是通過FTP推送給商戶。使用該接口,商戶需要事先聯系我司運營中心(95534-6;cp_operation@chinapay.com),進行接收地址/FTP地址的配置,配置完成后方可使用。
通知商戶的地址規范
目前商戶獲取對賬文件,有http通知及FTP推送兩種方式,具體說明如下:
https方式
1)商戶提供https地址(不能包含參數)
2)ChinaPay向商戶提供的URL發送請求,請求中包含對賬文件下載地址,其中:download為參數名稱
序號 |
字段 |
含義 |
示例 |
1 |
download |
文件下載地址 |
https://xxx.xxx.xxx/xxxx/000050000022826_20150627_20150629155000.txt.zip |
3)商戶地址收到ChinaPay的通知請求后,需返回包含“ChinapayOK”,表示商戶已收到通知。否則ChinaPay會反復通知5次后停止重發;商戶如有需要,可聯系ChinaPay運營中心,由人工重發通知。
4)ChinaPay保留三周的下載文件
ftp方式
1)商戶提供ftp地址,路徑、用戶名及密碼
2)ChinaPay向商戶提供的ftp地址推送對賬文件
3)ChinaPay向商戶ftp推送對賬文件失敗后,ChinaPay會反復推送5次后停止推送;商戶如有需要,可聯系ChinaPay運營中心,由人工重新發送。
4)ChinaPay保留三周的下載文件
結算文件名規則
結算文件名規則文件名格式:商戶號_結算日期_生成文件時間戳(yyyyMMddHHmmss).txt.zip
- 商戶號:長度15位
- 支付成功日期:8位
- 時間戳:yyyyMMddHHmmss
例如: 000050000022826_20150627_20150629155000.txt.zip
商戶結算文件格式(版本號:20150813)
l 文件樣例如下:
- 每行各字段用豎線分隔
- 首行為匯總信息,依次為:
字段 |
含義 |
格式 |
Version |
結算文件版本號 |
8位 |
liqDate |
結算日期 |
YYYYMMDD |
PurCnt |
支付筆數 |
整數,如123 |
PurAmt |
支付金額 |
小數,如123.45 |
FeeAmt |
手續費金額 |
小數,如123.45 |
RefCnt |
退款筆數 |
整數,如123 |
RefAmt |
退款金額 |
小數,如123.45 |
RefCancelCnt |
退款撤銷筆數 |
整數,如123 |
RefCancelAmt |
退款撤銷金額 |
小數 |






消費類交易接口
ChinaPay的網上支付服務采用WEB服務的方式允許商戶接入,接收交易數據的地址為:
Ø 測試環境請求地址:
- 前臺交易URL:
http://newpayment-test.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0
- 后臺交易URL:
http://newpayment-test.chinapay.com/CTITS/service/rest/forward/sta/000000000017/0/0/0/0/0
Ø 生產環境請求地址:
- 前臺交易URL:
https://payment.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0
- 后臺交易URL:
https://payment.chinapay.com/CTITS/service/rest/forward/sta/000000000017/0/0/0/0/0
說明:
走前臺地址的交易:0001個人網銀支付、0002企業網銀支付、0004快捷支付、0005賬單支付、0006認證支付、0007分期付款、0201預授權交易。
走后臺地址的交易:0003授信交易、0008后臺支付。
后續類交易接口
ChinaPay的網上支付服務采用WEB服務的方式允許商戶接入,其中:
l 0401退款、0402退款撤銷、0409退款重匯、9908通知分賬的交易接收地址如下:
Ø 測試環境請求地址:
http://newpayment-test.chinapay.com/CTITS/service/rest/forward/syn/000000000065/0/0/0/0/0
Ø 生產環境請求地址:
https://payment.chinapay.com/CTITS/service/rest/forward/syn/000000000065/0/0/0/0/0
l 0403消費撤銷、0203預授權撤銷、0204預授權完成撤銷、0202預授權完成的交易接收地址如下:
Ø 測試環境請求地址:
http://newpayment-test.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0
Ø 生產環境請求地址:
https://payment.chinapay.com/CTITS/service/rest/page/nref/000000000017/0/0/0/0/0
交易查詢接口
ChinaPay的網上支付服務采用WEB服務的方式允許商戶接入,接收交易數據的地址為:
Ø測試環境:
http://newpayment-test.chinapay.com/CTITS/service/rest/forward/syn/000000000060/0/0/0/0/0
Ø生產環境:
https://payment.chinapay.com/CTITS/service/rest/forward/syn/000000000060/0/0/0/0/0
交易對賬接口
對于已經提交給ChinaPay平臺的交易,ChinaPay會在第二天生成商戶對賬文件,包括T-1日商戶所有的交易(其中退款交易為商戶已審核通過的退款明細),以供商戶對賬使用。對賬文件生成后,ChinaPay后臺通知商戶下載或是通過FTP推送給商戶。使用該接口,商戶需要事先聯系我司運營中心(95534-6;cp_operation@chinapay.com),進行接收地址/FTP地址的配置,配置完成后方可使用。
通知商戶的地址規范
目前商戶獲取對賬文件,有http通知及FTP推送兩種方式,具體說明如下:
https方式
1)商戶提供https地址(不能包含參數)
2)ChinaPay向商戶提供的URL發送請求,請求中包含對賬文件下載地址,其中:download為參數名稱
序號 |
字段 |
含義 |
示例 |
1 |
download |
文件下載地址 |
https://xxx.xxx.xxx/xxxx/000050000022826_20150627_20150629155000.txt.zip |
3)商戶地址收到ChinaPay的通知請求后,需返回包含“ChinapayOK”,表示商戶已收到通知。否則ChinaPay會反復通知5次后停止重發;商戶如有需要,可聯系ChinaPay運營中心,由人工重發通知。
4)ChinaPay保留三周的下載文件
ftp方式
1)商戶提供ftp地址,路徑、用戶名及密碼
2)ChinaPay向商戶提供的ftp地址推送對賬文件
3)ChinaPay向商戶ftp推送對賬文件失敗后,ChinaPay會反復推送5次后停止推送;商戶如有需要,可聯系ChinaPay運營中心,由人工重新發送。
4)ChinaPay保留三周的下載文件
結算文件名規則
結算文件名規則文件名格式:商戶號_結算日期_生成文件時間戳(yyyyMMddHHmmss).txt.zip
- 商戶號:長度15位
- 支付成功日期:8位
- 時間戳:yyyyMMddHHmmss
例如: 000050000022826_20150627_20150629155000.txt.zip
商戶結算文件格式(版本號:20150813)
l 文件樣例如下:
- 每行各字段用豎線分隔
- 首行為匯總信息,依次為:
字段 |
含義 |
格式 |
Version |
結算文件版本號 |
8位 |
liqDate |
結算日期 |
YYYYMMDD |
PurCnt |
支付筆數 |
整數,如123 |
PurAmt |
支付金額 |
小數,如123.45 |
FeeAmt |
手續費金額 |
小數,如123.45 |
RefCnt |
退款筆數 |
整數,如123 |
RefAmt |
退款金額 |
小數,如123.45 |
RefCancelCnt |
退款撤銷筆數 |
整數,如123 |
RefCancelAmt |
退款撤銷金額 |
小數 |







