中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊中國聯(lián)通電子渠道中心2009年12月中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊變更記錄31總體概述411方案適用范圍412方案起草單位413方案的相關(guān)權(quán)利414名詞解釋42電子渠道統(tǒng)一支付平臺接入總體方案521背景522統(tǒng)一支付平臺523業(yè)務(wù)支付平臺功能描述524支付機構(gòu)功能描述63業(yè)務(wù)流程描述631支付流程632退款流程833對賬流程94與支付機構(gòu)之間的接口定義1041接入方式10411頁面重定向方式10412點對點接口方式1042接口定義10421支付機構(gòu)側(cè)接口10422支付平臺側(cè)接口245附錄2651加解密概述2652業(yè)務(wù)平臺編碼2753支付機構(gòu)編碼2754支付渠道編碼2755統(tǒng)一支付平臺流水規(guī)則2956統(tǒng)一支付平臺返回編碼29中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊變更記錄序號變更內(nèi)容說明版本號版本日期執(zhí)筆人1討論稿1020091110戴俊、張寅、梁曄2分離出支付機構(gòu)接口分冊1020091113梁曄3修改所有接口輸入、輸出字段1120091126梁曄4增加退款對賬接口122009126錢寶超5修改加密順序和實時訂單查詢接口字段132009128戴俊6修正了所有以ID結(jié)尾的參數(shù)的規(guī)范，統(tǒng)一定為ID將查詢接口中MERCHANTID，與其他接口一致，修正為MERCHANTSID去除了實時訂單查詢接口中簽名中的SIGN_HAMC字段擴展了商品名稱、商品描述的長度142009128張寅7重新解釋了PARTNERID的定義擴展了支付渠道編碼中，對于企業(yè)帳戶B2B的支持?jǐn)U充了統(tǒng)一支付平臺返回編碼修正了退款接口異常返回情況修正了退款對賬文件名修正了對賬文件獲取方式修正了對賬文件的描述修正了支付機構(gòu)編碼新增了幾家支付渠道、修正了支付渠道編碼152010118張寅中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊1總體概述11方案適用范圍為了實現(xiàn)對電子渠道現(xiàn)有具有支付功能的業(yè)務(wù)系統(tǒng)進(jìn)行支付業(yè)務(wù)支撐，實現(xiàn)支付合作伙伴的統(tǒng)一接入，特制定本規(guī)范，本規(guī)范適用于接入電子渠道的各支付機構(gòu)。12方案起草單位本方案的起草單位為中國聯(lián)通總部電子渠道中心以及聯(lián)創(chuàng)科技（南京）有限公司。13方案的相關(guān)權(quán)利本方案的解釋權(quán)屬于中國聯(lián)通總部電子渠道中心。本方案增補、修訂權(quán)屬中國聯(lián)通總部電子渠道中心。14名詞解釋名詞與術(shù)語解釋與說明業(yè)務(wù)平臺通過統(tǒng)一支付平臺使用支付功能的各業(yè)務(wù)系統(tǒng)。中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊名詞與術(shù)語解釋與說明支付機構(gòu)具備接入支付渠道功能的支付提供商。對帳業(yè)務(wù)平臺、支付平臺、支付機構(gòu)三方核對帳目的過程，分為支付平臺與支付機構(gòu)對賬、支付平臺與業(yè)務(wù)平臺對賬兩部分。統(tǒng)一支付平臺（UDP）接入支付機構(gòu)，為業(yè)務(wù)平臺提供支付服務(wù)的平臺支付類型支付渠道的類別支付訂單統(tǒng)一平臺中所有支付交易的唯一標(biāo)識支付渠道支付機構(gòu)下屬的各支付銀行或支付賬戶2電子渠道統(tǒng)一支付平臺接入總體方案21背景隨著電子渠道系統(tǒng)建設(shè)的不斷發(fā)展，系統(tǒng)積累越多，出于規(guī)劃和長期發(fā)展的目的，需要對各系統(tǒng)的一些共性的東西提取出來單獨處理，目前2G商城，3G商城，一卡充，固網(wǎng)交費，手機交費，都存在支付模塊，為了拓展業(yè)務(wù)范圍以及統(tǒng)一管理，建設(shè)統(tǒng)一支付平臺。22統(tǒng)一支付平臺統(tǒng)一支付平臺主要是針對各業(yè)務(wù)系統(tǒng)中支付模塊，提取出來，方便各業(yè)務(wù)系統(tǒng)的快速接入，以及各支付機構(gòu)的快速接入，為各業(yè)務(wù)平臺提供統(tǒng)一支付、統(tǒng)一退款、統(tǒng)一對賬功能，為各支付機構(gòu)提供統(tǒng)一管理、統(tǒng)一配置功能。23業(yè)務(wù)支付平臺功能描述本規(guī)范業(yè)務(wù)平臺指的是具有支付功能的電子渠道業(yè)務(wù)系統(tǒng)，諸如2G商城，3G商城，一卡充，固網(wǎng)交費，手機交費等。中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊24支付機構(gòu)功能描述支付機構(gòu)是指在業(yè)務(wù)平臺需要支付功能的前提下，與統(tǒng)一支付平臺與各支付節(jié)點之間建立的橋梁。它具有接入各支付銀行與自己下屬的各支付賬戶的能力。3業(yè)務(wù)流程描述31支付流程用戶業(yè)務(wù)平臺統(tǒng)一支付平臺支付機構(gòu)1選擇商品2生成業(yè)務(wù)平臺訂單3發(fā)送支付請求4業(yè)務(wù)鑒權(quán)7生成支付平臺訂單6用戶選擇確認(rèn)支付渠道5展示支付渠道選擇頁面8發(fā)送支付請求9處理支付請求10支付機構(gòu)回調(diào)11發(fā)起支付回調(diào)驗證12處理支付回調(diào)驗證13支付回調(diào)驗證成功14處理訂單15支付平臺回調(diào)16處理訂單17展示交易結(jié)果頁面支付流程詳細(xì)描述1、用戶在業(yè)務(wù)平臺選擇需要購買的商品，發(fā)起購買請求；2、業(yè)務(wù)平臺生成業(yè)務(wù)平臺訂單；3、業(yè)務(wù)平臺通過支付接口向支付平臺發(fā)起支付請求；中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊4、支付平臺通過對業(yè)務(wù)平臺支付請求進(jìn)行業(yè)務(wù)鑒權(quán)；1根據(jù)業(yè)務(wù)平臺編碼獲取解密密鑰對請求參數(shù)進(jìn)行解密；2校驗請求參數(shù)A判斷業(yè)務(wù)平臺功能是否具備支付請求的權(quán)限；B校驗請求時間戳是否失效；3支付網(wǎng)關(guān)根據(jù)業(yè)務(wù)平臺功能編碼適配對應(yīng)支付渠道5、展現(xiàn)對應(yīng)支付渠道；6、用戶選擇支付渠道進(jìn)行支付；7、支付平臺生成支付平臺訂單；8、支付網(wǎng)關(guān)生成請求參數(shù)并向?qū)?yīng)支付機構(gòu)發(fā)起支付請求；9、支付機構(gòu)處理支付平臺支付請求；10、支付機構(gòu)回調(diào)支付平臺；11、支付網(wǎng)關(guān)接收到支付機構(gòu)回調(diào)后，向支付機構(gòu)發(fā)起訂單驗證請求備注支付網(wǎng)關(guān)判斷支付機構(gòu)是否支持防釣魚功能，如果支付機構(gòu)不支持該功能直接跳到第14步；12、支付機構(gòu)處理支付平臺回調(diào)驗證請求；13、支付平臺收到支付機構(gòu)訂單驗證請求成功信息；14、支付平臺處理支付平臺訂單；15、支付平臺向業(yè)務(wù)平臺發(fā)起訂單回調(diào)請求；16、業(yè)務(wù)平臺處理業(yè)務(wù)平臺訂單；17、展示交易結(jié)果頁面。中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊32退款流程用戶業(yè)務(wù)平臺統(tǒng)一支付平臺1用戶選擇退款2處理退款請求3向統(tǒng)一支付平臺發(fā)起退款請求5處理業(yè)務(wù)平臺退款請求6向支付機構(gòu)發(fā)起退款請求4業(yè)務(wù)鑒權(quán)7支付機構(gòu)處理退款請求9發(fā)起退款回調(diào)驗證10處理退款回調(diào)驗證11退款回調(diào)驗證成功8支付機構(gòu)回調(diào)支付平臺13支付平臺回調(diào)業(yè)務(wù)平臺12處理訂單14處理業(yè)務(wù)平臺訂單15展示退款結(jié)果退款流程詳細(xì)描述1、用戶在業(yè)務(wù)平臺選擇需要退款的訂單，發(fā)起退款請求；2、業(yè)務(wù)平臺處理退款請求；3、業(yè)務(wù)平臺通過退款接口向支付平臺發(fā)起退款請求；4、支付平臺通過對業(yè)務(wù)平臺退款請求進(jìn)行業(yè)務(wù)鑒權(quán)；1根據(jù)業(yè)務(wù)平臺編碼獲取解密密鑰對請求參數(shù)進(jìn)行解密；2校驗請求參數(shù)A判斷業(yè)務(wù)平臺功能是否具備退款請求的權(quán)限；B校驗請求時間戳是否失效；5、支付平臺處理業(yè)務(wù)平臺退款請求；6、支付網(wǎng)關(guān)生成請求參數(shù)并向?qū)?yīng)支付機構(gòu)發(fā)起退款請求；7、支付機構(gòu)處理支付平臺退款請求；8、支付機構(gòu)回調(diào)支付平臺；9、支付網(wǎng)關(guān)接收到支付機構(gòu)回調(diào)后，向支付機構(gòu)發(fā)起訂單驗證請求備注支付網(wǎng)關(guān)判斷支付機構(gòu)是否支持防釣魚功能，如果支付機構(gòu)不支持該功能直接跳到第12步；10、支付機構(gòu)處理支付平臺回調(diào)驗證請求；11、支付平臺收到支付機構(gòu)退款訂單驗證請求成功信息；中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊12、支付平臺處理支付平臺訂單；13、支付平臺向業(yè)務(wù)平臺發(fā)起訂單回調(diào)請求；14、業(yè)務(wù)平臺處理業(yè)務(wù)平臺訂單；15、展示退款結(jié)果頁面。33對賬流程業(yè)務(wù)平臺統(tǒng)一支付平臺支付機構(gòu)1支付機構(gòu)生成對賬文件2上傳至支付平臺FTP服務(wù)器3支付平臺內(nèi)部對賬4支付平臺生成各業(yè)務(wù)平臺對賬文件5從支付平臺FTP服務(wù)器獲取對賬文件6業(yè)務(wù)平臺進(jìn)行對賬對賬流程詳細(xì)描述1、支付機構(gòu)生成對賬文件；2、支付機構(gòu)在每日200以前將對賬文件上傳至支付平臺FTP服務(wù)器指定目錄下；3、支付平臺進(jìn)行內(nèi)部對賬；4、支付平臺對賬完成后根據(jù)對賬結(jié)果按照業(yè)務(wù)平臺生成單獨業(yè)務(wù)平臺對賬文件；5、業(yè)務(wù)平臺在每日300后從支付平臺FTP獲取對賬文件；6、業(yè)務(wù)平臺進(jìn)行內(nèi)部對賬。中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊4與支付機構(gòu)之間的接口定義41接入方式411頁面重定向方式頁面重定向方式是指通過用戶的瀏覽器，從發(fā)起方系統(tǒng)頁面跳轉(zhuǎn)到落地方系統(tǒng)頁面，整個過程是和用戶進(jìn)行交互的，需要用戶輸入相關(guān)驗證信息以及擁有一些安全防盜機制。412點對點接口方式點對點接口方式是指通過用戶的初始信息由發(fā)起方系統(tǒng)通過接口與落地方系統(tǒng)完成交互，整個過程對用戶是透明的，用戶在其中不進(jìn)行交互。42接口定義注所有接口加密是按KEYVALUE，簽名是按所列舉的VALUE值，加密的順序是按KEY的字母順序排序，簽名放在最后一個，而簽名是嚴(yán)格按規(guī)范中的VALUE順序簽名。421支付機構(gòu)側(cè)接口4211支付接口接口采用HTTP協(xié)議。接口方法為HTTP/PAYPROVIDER/PAYPARTNERID100001SERVLETOUTPUTSTREAMPRINT“SUCCESS“SERVLETOUTPUTSTREAMFLUSH告知支付平臺，已經(jīng)成功處理，支付平臺解析返回流，收到SUCCESS，則不需要再次回調(diào)。4222支付分賬回調(diào)接口同4221支付回調(diào)接口注1、支付回調(diào)瀏覽器重定向回調(diào)優(yōu)先級高于服務(wù)器點對點回調(diào)，支付機構(gòu)回調(diào)支付平臺時需要首先發(fā)起瀏覽器重定向回調(diào)，間隔2分鐘后再發(fā)起點對點回調(diào)。支付平臺第一次收到支付機構(gòu)的點對點請求后，如果支付平臺已經(jīng)處理完畢該筆訂單，則通過SERVLETOUTPUTSTREAMSERVLETOUTPUTSTREAMRESPONSEGETOUTPUTSTREAMSERVLETOUTPUTSTREAMPRINT“SUCCESS“SERVLETOUTPUTSTREAMFLUSH告知支付平臺，已經(jīng)成功處理，支付平臺解析返回流，收到SUCCESS，則不需要再次回調(diào)。PAYPROVIDERORDER支付機構(gòu)流水號STRING30是MERCHANTSID商戶號STRING50是NOTIFYID訂單驗證IDSTRING50否用于驗證訂單合法性NOTIFYTYPE回調(diào)類型STRING2是1瀏覽器重定向2服務(wù)器點對點回調(diào)CURRENCY幣種STRING10否默認(rèn)是人民幣RMBSERVICETYPE業(yè)務(wù)類型STRING10是支付默認(rèn)為DIRECTPAYSIGN_HMAC數(shù)字摘要STRING50是中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊5附錄51加解密概述統(tǒng)一支付平臺要求報文在網(wǎng)絡(luò)上傳輸時，通過密文形式。支持3DES、RSA兩種加密方式，中國聯(lián)通統(tǒng)一為支付機構(gòu)不同的合作伙伴或者商戶號分配密匙。支付機構(gòu)根據(jù)自有平臺特點，可以申請使用3DES對稱加密，或者RSA不對稱加密。52業(yè)務(wù)平臺編碼53支付機構(gòu)編碼名稱英文名編碼易寶YEEPAY01銀聯(lián)UNIONPAY02支付寶ALIPAY03類別平臺名稱平臺英文名業(yè)務(wù)平臺編碼業(yè)務(wù)功能名稱業(yè)務(wù)功能編碼購買充值卡100001手機直充100002一卡充UPP10固網(wǎng)直充100003手機交費110001手機交費MOBILEPAYBILL11手機交費站110002交費充值類固網(wǎng)交費FIXPAYBILL12固網(wǎng)交費120001購買2G號碼210001購買上網(wǎng)卡210002購買3G手機210003購買186號碼210004購買上網(wǎng)本210005優(yōu)惠購機210006IPHONE合約計劃210007商城類聯(lián)通商城UNICOMSALES21購買IPHONE210008中間帳戶中間帳戶EPAY31中間帳戶充值310001中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊環(huán)迅INTERPAY04財付通TENPAY0554支付渠道編碼在統(tǒng)一支付平臺中，支付渠道是確定用戶支付的標(biāo)識，選擇了不同的支付渠道，對于用戶而言，就是選擇了不同的支付方式。以下列表為默認(rèn)使用個人銀行帳戶編碼，如果支付機構(gòu)支持企業(yè)帳戶支付，即B2B的支付，則對應(yīng)渠道編碼在下表中的編碼后面增加B2B后綴。如，使用中國工商銀行個人帳戶支付，則支付平臺填寫編碼為ICBC，如果支付機構(gòu)支持中國工商銀行企業(yè)帳戶支付，同時用戶也選擇使用企業(yè)帳戶支付的情況下，支付平臺填寫給支付機構(gòu)的編碼為ICBCB2B。企業(yè)帳戶的支付功能開通與否視各支付機構(gòu)而定，由各支付機構(gòu)提交本系統(tǒng)支持的企業(yè)帳戶支付渠道。支付渠道名稱支付渠道編碼易寶自有帳戶1YEEPAY01易寶自有帳戶2YEEPAY02易寶自有帳戶3YEEPAY03支付寶自有帳戶1ALIPAY01支付寶自有帳戶2ALIPAY02支付寶自有帳戶3ALIPAY03財付通自有帳戶1TENPAY01財付通自有帳戶2TENPAY02財付通自有帳戶3TENPAY03環(huán)迅自有帳戶1INTERPAY01環(huán)迅自有帳戶2INTERPAY02環(huán)迅自有帳戶3INTERPAY03銀聯(lián)自有帳戶1UNIONPAY01銀聯(lián)自有帳戶2UNIONPAY02銀聯(lián)自有帳戶3UNIONPAY03中國工商銀行ICBC中國農(nóng)業(yè)銀行ABC北京銀行BCCB交通銀行BOCO建設(shè)銀行CCB興業(yè)銀行CIB招商銀行CMBCHINA中國民生銀行CMBC光大銀行CEB中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊中信實業(yè)銀行ECITIC中國郵政儲蓄POST深圳發(fā)展銀行SDB上海浦東發(fā)展銀行SPDB廣東發(fā)展銀行GDB上海農(nóng)村商業(yè)銀行SHRCB順德農(nóng)村信用社SDE廣州農(nóng)村信用社GNXS廣州市商業(yè)銀行GZCB南京銀行NJCB華夏銀行HXB渤海銀行CBHB重慶銀行CQB浙商銀行CZB東亞銀行HKBEA平安銀行PAB南海農(nóng)村信用社NHB中國銀行BOC寧波銀行NBCB廈門商業(yè)銀行XMCCB中國信合CNRCU浙江稠州商業(yè)銀行CZCB杭州銀行HZB上海銀行SHB北京農(nóng)村商業(yè)銀行BJNCB55統(tǒng)一支付平臺流水規(guī)則統(tǒng)一支付平臺中，所有接入的系統(tǒng)在保留原有業(yè)務(wù)平臺流水的基礎(chǔ)上，為了方便各業(yè)務(wù)平臺系統(tǒng)之間的抽象、以及與統(tǒng)一支付平臺系統(tǒng)的融合，需要在統(tǒng)一支付平臺內(nèi)增加屬于統(tǒng)一支付平臺的流水，生成規(guī)則如下123456789101112131415161718192021222324第1位至第3位為統(tǒng)一支付平臺縮寫，統(tǒng)一填寫為UDP；第4位至第17位為精確到秒的時間戳，格式為YYYYMMDDHHMISS；第18位至第22位為可循環(huán)的自增長序列，從數(shù)據(jù)庫獲??；第23位至第24位為業(yè)務(wù)平臺編碼，共兩位，參見業(yè)務(wù)平臺編碼。中國聯(lián)通電子渠道統(tǒng)一支付平臺接入規(guī)范支付機構(gòu)接入分冊56統(tǒng)一支付平臺返回編碼返回結(jié)果英文名稱返回編碼成功SUCCESS0000數(shù)字摘要錯誤HMAC_ERROR9001解密錯誤DECRYPT_ERROR9002未知錯誤UNKNOWN9999支付失敗PAY_FAIL1000回調(diào)失敗RETURN_FAIL2000驗證失敗VERIFY_FAI