支付平臺線上統(tǒng)一對賬接口說明V0.2.docx_第1頁
支付平臺線上統(tǒng)一對賬接口說明V0.2.docx_第2頁
支付平臺線上統(tǒng)一對賬接口說明V0.2.docx_第3頁
支付平臺線上統(tǒng)一對賬接口說明V0.2.docx_第4頁
支付平臺線上統(tǒng)一對賬接口說明V0.2.docx_第5頁
已閱讀5頁，還剩9頁未讀， 繼續(xù)免費(fèi)閱讀

下載本文檔

版權(quán)說明：本文檔由用戶提供并上傳，收益歸屬內(nèi)容提供方，若內(nèi)容存在侵權(quán)，請進(jìn)行舉報(bào)或認(rèn)領(lǐng)

文檔簡介

1、創(chuàng)業(yè)健保付聚合支付平臺線上統(tǒng)一對賬接口說明2017年5月健保付技術(shù)部本文檔中的所有內(nèi)容為中福支付科技有限公司的機(jī)密和專屬所有。未經(jīng)中福支付科技有限公司的明確書面許可，任何組織或個人不得以任何目的、任何形式及任何手段復(fù)制或傳播本文檔部分或全部內(nèi)容。No字段名稱Tag類型必輸備注<Data>.<Results><Result>1、健康卡卡號HealthCardldC(32)2、姓名NameC(32)3、交易時間CreateTimeC(20)4、交易金額AmtN(22,2)5、交易類型TransTypeN(l)1APP支付（線上）3掃碼付（線下）4條碼付（線下）6

2、、業(yè)務(wù)單號OrderNOC(32)7、收款商戶代碼MerchantNoC(32)8、收款商戶名稱MerchantNameC(100)9、交易渠道編'VPaychanneln（i）2支付寶3微信4銀聯(lián)10、手機(jī)號碼MobileC(20)</Result></Results></Data>第4章附錄4.1返回碼I©(retcode)No參數(shù)說明1、0000成功2、9999失敗4.2行政區(qū)代碼國標(biāo)GB/T226020074.3性別代碼代碼Va1ue值1男2女4.4職業(yè)代碼代碼Va1ue值0國家機(jī)關(guān)、黨群組織、企業(yè)、事業(yè)單位負(fù)責(zé)人1專業(yè)技術(shù)人員3辦

3、事人員和有關(guān)人員4商業(yè)、服務(wù)業(yè)人員/5農(nóng)、林、牧、漁、水利業(yè)生產(chǎn)人員6生存、運(yùn)輸設(shè)備操作人員及有關(guān)人員X軍人Y不便分類的其他從業(yè)人員4.5文化程度代碼Value值10研究生教育11博士研究生畢業(yè)12博士研究生結(jié)業(yè)13博士研究生肄業(yè)14碩士研究生畢業(yè)15碩士研究生結(jié)業(yè)16碩士研究生肄業(yè)17研究生班畢業(yè)18研究生班結(jié)業(yè)19研究生班肄業(yè)20大學(xué)本科21大學(xué)本科畢業(yè)22大學(xué)本科結(jié)業(yè)23大學(xué)本科肄業(yè)28大學(xué)普通班畢業(yè)30?？平逃?1大學(xué)專科畢業(yè)32大學(xué)?？平Y(jié)業(yè)33大學(xué)?？埔迾I(yè)40中等職業(yè)教育41中等?？飘厴I(yè)42中等?？平Y(jié)業(yè)43中等專科肄業(yè)44職業(yè)高中畢業(yè)45職業(yè)高中結(jié)業(yè)46職業(yè)高中肄業(yè)47技工學(xué)校畢業(yè)4

4、8技工學(xué)校結(jié)業(yè)49技工學(xué)校肄業(yè)60普通高級中學(xué)教育61普通高中畢業(yè)62普通高中結(jié)業(yè)63普通高中肄業(yè)70初級中學(xué)教育71初中畢業(yè)73初中肄業(yè)80小學(xué)教育81小學(xué)畢業(yè)83小學(xué)肄業(yè)90其他國籍/地區(qū)代碼Va1ue值01中國02中國香港澳門03中國臺灣04海外4.6證件類型代碼Va1ue值01居民身份證03護(hù)照06港澳居民來往大陸通行證07臺灣居民來往大陸通行證4.7卡類型代碼Va1ue值A(chǔ)5健康虛擬卡A6健康實(shí)體卡A2社?？?.8通道類別代碼Va1ue值1健康錢包2支付寶3微信4銀聯(lián)卡修訂歷史發(fā)布日期版本修訂人審閱人摘要2017-05-08V0.1gyp文檔創(chuàng)建2017-07-14V0.2gyp增加

5、3.4節(jié)聚合支付明細(xì)查詢接口目錄修訂歷史2第1章概述41.1文檔說明41.2讀者43術(shù)語約定4第2章接口規(guī)范41網(wǎng)絡(luò)通信方式42.2語法42.3接口報(bào)文約定42.4請求有效性驗(yàn)證算法6第3章支付平臺線上統(tǒng)一對賬接口定義說明63.1支付訂單同步接口63.2退款訂單同步73.3商戶號校驗(yàn)83.4聚合支付明細(xì)查詢9第4章附錄104.1返回碼(retcode)104.2行政區(qū)代碼104.3性別代碼114.4職業(yè)代碼114.5文化程度114.6國籍/地區(qū)134.7證件類型134.8卡類型134.9通道類別13第1章概述1.1文檔說明1.2讀者本文檔的閱讀對象為app開發(fā)人員1.3術(shù)語約定第2章接口規(guī)范2

6、.1網(wǎng)絡(luò)通信方式以http/https協(xié)議，服務(wù)器點(diǎn)對點(diǎn)post方式進(jìn)行數(shù)據(jù)通信2.2語法消息體采用XML格式描述，消息體的語法規(guī)則完全遵循XML語法規(guī)則，并嚴(yán)格區(qū)分大小寫。2.3接口報(bào)文約定2.3.1接口通信地址接口地址:https:/*/gatewayOnline/gateway/portal/execute語法消息體采用XML格式描述，消息體的語法規(guī)則完全遵循XML語法規(guī)則，并嚴(yán)格區(qū)分大小寫。每一個消息由一個消息頭和消息體構(gòu)成。其中消息是由一個完整的XML加密而來。一個完整的消息如下圖所示：消消息頭消息頭內(nèi)容息消息體業(yè)務(wù)要素1內(nèi)容體整個XML格式的消息體以Data為根節(jié)點(diǎn)，即完整的消息報(bào)

7、文例子如下:v?xmlversion='l.0encoding="UTF-8"?<Root><Head><MerchantNo>00001</MerchantNo><Funcid>函數(shù)名v/Funcid>vRetCode>0000</RetCode><RetMsg>success</RetMsg><Timestamp>234423234</Timestamp><Signature>ADSSSSSSSDWW</Signa

8、ture>將原文用私鑰簽名以后的內(nèi)容</Head><Body>AAAAAAAAAAAAAAAAAAAAAAAAAAAA將BODY原文經(jīng)過DES加密后的字符串</Body></Data></Root>BODY原文如下<Data><HealthCardId>HealthCardId</HealthCardId><Signature>2113333334440</Signature><Data>2.3.2消息頭每一個會話或應(yīng)用消息有一個消息頭，該消息頭指明消息類型

9、、發(fā)送起始點(diǎn)、發(fā)送目的地、發(fā)送時間、消息標(biāo)識號以及其他一些通用信息。消息頭格式如下：No字段名稱字段類型必輸備注1、商戶號MerchantNoC(20)平臺為開發(fā)者提供的商戶號2、返回碼RetCodeC(4)0000成功9999失敗3、錯誤描述RetMsgC(100)4、功能碼FuncidC(6)V5、時間戳TimestampC(100)V自1970-1-0100:00:00.000到當(dāng)前時刻的時間距離（精確到毫秒）6、簽名碼SignatureC(500)簽名以后的字符串2.4請求有效性驗(yàn)證算法支付系統(tǒng)接口服務(wù)和商戶系統(tǒng)約定統(tǒng)一的請求指令驗(yàn)證算法。> 算法原理：將數(shù)據(jù)域通過Des加密后放

10、入Body中，并將原文通過RSA私鑰簽名得到結(jié)果放入消息頭Signature中> 算法規(guī)則：先用密鑰將數(shù)據(jù)解密得到原文，再用RSA公鑰匙對原文進(jìn)行驗(yàn)簽。第3章支付平臺線上統(tǒng)一對賬接口定義說明3.1支付訂單同步接口發(fā)起方：商戶后臺功能碼：P9001場景描述：接口設(shè)計(jì)：將線上支付的訂單同步到統(tǒng)一支付平臺發(fā)送sdata報(bào)文：消息頭：見2.3.3消息體：No字段名稱Tag類型必填備注<Data><0rders><0rder>（此節(jié)點(diǎn)可以有多個）1.健康卡號HealthCardldC(30)2.手機(jī)號碼MobileC(20)J支付人手機(jī)號碼3.外部訂單號orde

11、r_noC(30)V發(fā)送到支付寶微信的訂單號碼4.支付渠道編號paytypen（i）J2支付寶3微信5.支付金額AmtN(22,2)V應(yīng)答報(bào)文:6.姓名NameC(30)V7.收款商戶號MerchantNoC(30)V支付寶微信的商戶號8.交易時間TransdateTimeC(2)V日期格式：yyyyMMdd，例如：20160802、201212129.訂單超時時間PayTimeOutN(10)以分鐘為單位10.商品標(biāo)題OrderSubjectC(250)J11.訂單描述OrderDetailC(250)V12.操作員OptC(20)13.備注RemarkC(10)</0rder>

12、</Orders></Data>No字段名稱Tag類型必輸備注<Data><Results><Result>1、外部訂單號OrderNo2、結(jié)果代碼CodeSUCCESS成功FAIL失敗3、錯誤描述Msg錯誤描述</Result></Results></Data>3.2退款訂單同步發(fā)起方：商戶app功能碼：P9002場景描述：接口設(shè)計(jì)：退款的訂單同步到支付平臺發(fā)送sdata報(bào)文：消息頭：見2.3.3消息體：No字段名稱Tag類型必填備注<Data><0rders><0r

13、der>（此節(jié)點(diǎn)可以有多個）1.退款訂單號RequestNoC(30)V2.健康卡卡c-HealthCardldC(32)3.支付渠道編號PayTypen（i）J4.退款金額AmtN(22,2)V5.支付原訂單號TradeNoC(30)J6.收款商戶號MerchantNoC(2)V支付寶微信為醫(yī)院分配的商戶號</0rder></0rders></Data>應(yīng)答報(bào)文:No字段名稱Tag類型必輸備注<Data>.<Results><Result>1、外部訂單號OrderNo2、結(jié)果代碼CodeSUCCESS成功FAIL失

14、敗3、錯誤描述Msg錯誤描述</Result></Results></Data>3.3商戶號校驗(yàn)發(fā)起方：APP后臺功能碼：P9003場景描述：接口設(shè)計(jì)：校驗(yàn)支付寶/微信分配的商戶號在支付平臺后臺有沒有維護(hù)發(fā)送sdata報(bào)文：消息頭：見2.3.3消息體:No字段名稱Tag類型必填備注<Data>1.支付渠道編號PayTypen（i）J2.收款商戶號MerchantNoC(2)V支付寶微信為醫(yī)院分配的商戶號</Data>應(yīng)答報(bào)文:No字段名稱Tag類型必輸備注<Data>1、結(jié)果代碼CodeSUCCESS成功FAIL失敗2、錯誤描述Msg錯誤描述</Data>3.4聚合支付明細(xì)查詢發(fā)起方：APP后臺功能碼：P9004場景描述：接口設(shè)計(jì)：通過健康卡卡號查詢該健康卡下的交易明細(xì)數(shù)據(jù)發(fā)送sdata報(bào)文：消息頭：見2.3.3消息體:No字段名稱Tag類型必填備注<Data&g

溫馨提示

  • 1. 本站所有資源如無特殊說明，都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等，如果需要附件，請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙，網(wǎng)頁內(nèi)容里面會有圖紙預(yù)覽，若沒有圖紙預(yù)覽就沒有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫網(wǎng)僅提供信息存儲空間，僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理，對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯，并不能對任何下載內(nèi)容負(fù)責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容，請與我們聯(lián)系，我們立即糾正。
  • 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。

最新文檔

評論

0/150

提交評論