中國電信翼支付技術(shù)規(guī)范二維碼前置平臺接口分冊(對接外系統(tǒng))V10020160406

中國電信翼支付技術(shù)規(guī)范--二維碼前置接口(對接外系統(tǒng))分冊2015年6月前言中國電信翼支付訂單收款碼接口文檔目錄版本信息 2概述 21總體說明 21.1背景 21.2業(yè)務(wù)場景描述 21.3整體業(yè)務(wù)流程圖 21.4本規(guī)范適用說明 31.5通信方式 32數(shù)據(jù)類型 32.1基本數(shù)據(jù)類型 32.2符號定義 43接口約定 43.1API系統(tǒng)請求參數(shù)(SYSREQ) 43.2系統(tǒng)響應(yīng)參數(shù)(SYSRES) 54接口定義 54.1訂單二維碼解碼接口 54.2第三方提交訂單接口 75附錄 85.1返回代碼含義 8版本信息版本修改人日期修改內(nèi)容概述本文主要針對中國電信翼支付二維碼前置接口類型、接口字段及其格式取值進(jìn)行了規(guī)范說明。1總體說明1.1背景1.2業(yè)務(wù)場景描述適用于自動售貨機(jī)、自助繳費(fèi)終端機(jī)、停車場、iTV或出租車等，商戶有屏幕展示二維碼圖片，且無專門的收銀員或掃碼槍，用戶掃屏幕上的二維碼自助完成支付，商戶確認(rèn)用戶完成支付即提供商品或服務(wù)。1.3整體業(yè)務(wù)流程圖圖1整體業(yè)務(wù)流程圖1.4本規(guī)范適用說明中國電信翼支付二維碼前置接口標(biāo)準(zhǔn)。1.5通信方式HTTPPOST2數(shù)據(jù)類型2.1基本數(shù)據(jù)類型序號類型縮寫類型描述參考1a字母a－zA、a、ab2n數(shù)字0－91、12、-13s特殊字符@、#4an字母和數(shù)字字符Word25ans字母、數(shù)字和特殊字符Hell_wold16yyyy4位數(shù)年份2010（2010年）7MM年份中的月份03（3月份）8DD月份中的日期25（25號）9hh小時（24格式）15（15點(diǎn)）10mm分鐘30（30分）11ss秒59（59秒）2.2符號定義序號符號縮寫符號性質(zhì)符號說明1M強(qiáng)制域(Mandatory)此域必選，否則將被認(rèn)為格式出錯2C條件域(Conditional)此域在一定條件下必選3O選用域(Optional)此域由發(fā)送方自選3接口約定3.1API系統(tǒng)請求參數(shù)(SYSREQ)名稱說明類型必填最大長度備注method調(diào)用的接口ansM32根據(jù)各接口描述method定義傳參keep請求流水nM30外部自生成channelNo渠道標(biāo)識ansM201門戶02交費(fèi)易03資金歸集04企賬2.0version版本號anO10企業(yè)賬戶1.0或2.0sign數(shù)字簽名ansM64數(shù)字簽名3.2系統(tǒng)響應(yīng)參數(shù)(SYSRES)名稱說明類型必填最大長度備注responseCode響應(yīng)碼nM8代碼定義見5.1XXXXXXXX前兩位表示錯誤來源00：沒有錯誤01：前置平臺02：數(shù)據(jù)庫操作03：二維碼平臺04：業(yè)管平臺05：企業(yè)平臺后六位表示具體錯誤碼responseMsg響應(yīng)消息ansM128描述文字信息keep請求keepnM32請求參數(shù)傳入值Sign數(shù)字簽名ansM64數(shù)字簽名4接口定義4.1訂單二維碼生成接口測試環(huán)境訪問地址：71:7080/BarcodeFront/barcode/newCreate字段名稱類型必填說明serviceType業(yè)務(wù)類型ansM參考serviceType結(jié)構(gòu)定義keep請求流水a(chǎn)nsMchannelNo渠道標(biāo)識ansO如：01門戶02交費(fèi)易03資金歸集04企賬2.0timestamp時間戳ansM發(fā)送請求的時間，格式“yyyy-MM-ddHH:mm:ss”2015-01-0101:01:01bizContent業(yè)務(wù)參數(shù)ansMJSON格式，具體包含的內(nèi)容參見業(yè)務(wù)參數(shù)bizContent描述option可選項ansO擴(kuò)展項sign密文ansM對bizContent對象做MD5加密，如：accountNo+keyKey：BarcodeFront@bizContent：字段名稱類型必填說明accountNo翼支付賬戶ansM翼支付賬戶（企業(yè)賬戶）accountName翼支付賬戶名稱ansO翼支付賬戶名稱（企業(yè)賬戶）amount訂單金額ansO訂單總金額，單位為元，精確到小數(shù)點(diǎn)后兩位，取值范圍[0.01,100000000]expireTime超時時間ansO該二維碼允許的最晚有效時間，逾期將驗證失敗。格式為:yyyy-MM-ddHH:mm:ment備注ansO備注extension可選項ansO擴(kuò)展項orderCode訂單號ansO訂單號cashierChannelNo透傳渠道號ansO透傳渠道號（010005_1_001）,由翼支付分配terminaNumber終端號ansO由商戶傳入示例：{"serviceType":"BUSINESS_CHECKOUT","keep":"20150908092131000000001","channelNo":"150908092131000001","timestamp":"2015-01-0101:01:01","orderCode":"150908092131000001","cashierChannelNo":"3452343353245435""bizContent":{"accountNo":189.cn","accountName":"全家便利浦電路店","amount":"99.99","comment":"午餐",extension：{"orderCode":"150908092131000001","cashierChannelNo":"3452343353245435"“terminaNumber”:”451211545121212”}},"sign":"密文"}Sign加密原文：accountN&accountName=全家便利浦電路店&amount=99.99&comment=午餐&orderCode=150908092131000001&cashierChannelNo=345234335324543&KEY=BarcodeFront@響應(yīng)結(jié)果為標(biāo)準(zhǔn)JSON字符串。參數(shù)含義類型必填備注success是否成功booleanMtrue：成功false：失敗result調(diào)用返回值ansO當(dāng)success為true時取此值，errorCode、errorMsg為空各接口返回的結(jié)果屬性不同errorCode錯誤碼ansO當(dāng)success為false時取此值，result為空errorMsg錯誤描述ansO當(dāng)success為false時取此值，result為空請求成功success為true時響應(yīng)結(jié)果result為：屬性含義類型長度必填備注qrcode二維碼ansM4.2通知外系統(tǒng)接口規(guī)范通知外系統(tǒng)接口接口接口名稱企業(yè)賬戶入賬成功通知外系統(tǒng)接口接口描述企業(yè)賬戶入賬成功通知接口提供者二維碼前置平臺接口調(diào)用者翼支付客戶端接口類型HTTPPOST應(yīng)用場景企業(yè)賬戶入賬成功通知外系統(tǒng)接口調(diào)用形式測試環(huán)境地址：（由外系統(tǒng)提供）備注以JSON格式返回通知外系統(tǒng)接口參數(shù)字段含義類型長度必填備注SIGN加密串用于驗簽操作ORDERCODE訂單號M個人客戶端調(diào)用解碼接口后，調(diào)用二維碼前置生成訂單時透傳給二維碼前置TXNAMOUNT交易金額sM交易金額，單位為分OUTORDERNO翼支付訂單號OPHONE翼支付登錄賬號O通知外系統(tǒng)接口應(yīng)答參數(shù)字段含義類型長度必填備注RESPONSECODE響應(yīng)碼n8M00000000表示成功,其它狀態(tài)表示失敗RESPONSECONTENT響應(yīng)碼描述ansC響應(yīng)內(nèi)容ORDERCODE=150908092131000001&TXNAMOUNT=10&KEY=BarcodeFront@進(jìn)行md5加密4.3查詢支付狀態(tài)接口查詢支付狀態(tài)接口接口名稱外系統(tǒng)調(diào)用查詢支付狀態(tài)接口接口描述外系統(tǒng)調(diào)用查詢接口查看訂單入賬是否成功接口提供者二維碼前置平臺接口調(diào)用者翼支付客戶端接口類型HTTPPOST應(yīng)用場景外系統(tǒng)調(diào)用查詢接口查看訂單入賬是否成功接口調(diào)用形式測試環(huán)境地址：71:7080/BarcodeFront/barcode/METHODqueryPaymentStatus備注以JSON格式返回查詢支付狀態(tài)接口請求參數(shù)字段含義類型長度必填備注SIGN加密串用于驗簽操作ORDERCODE訂單號M外系統(tǒng)訂單號查詢支付狀態(tài)接口應(yīng)答參數(shù)字段含義類型長度必填備注RESPONSECODE響應(yīng)碼n8M00000000表示支付成功,00000001表示支付失敗00000002表示訂單不存在00000003表示未支付00000004表示待核查019999系統(tǒng)異常RESPONSECONTENT響應(yīng)碼描述ansC響應(yīng)內(nèi)容ORDERCODE=150908092131000001&KEY=BarcodeFront@md5加密5附錄5.1返回代碼含義000000