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


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


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






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







