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

下載本文檔

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

文檔簡(jiǎn)介

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

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

3、事人員和有關(guān)人員4商業(yè)、服務(wù)業(yè)人員/5農(nóng)、林、牧、漁、水利業(yè)生產(chǎn)人員6生存、運(yùn)輸設(shè)備操作人員及有關(guān)人員X軍人Y不便分類(lèi)的其他從業(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專(zhuān)科教育31大學(xué)專(zhuān)科畢業(yè)32大學(xué)專(zhuān)科結(jié)業(yè)33大學(xué)專(zhuān)科肄業(yè)40中等職業(yè)教育41中等專(zhuān)科畢業(yè)42中等專(zhuān)科結(jié)業(yè)43中等專(zhuān)科肄業(yè)44職業(yè)高中畢業(yè)45職業(yè)高中結(jié)業(yè)46職業(yè)高中肄業(yè)47技工學(xué)校畢業(yè)4

4、8技工學(xué)校結(jié)業(yè)49技工學(xué)校肄業(yè)60普通高級(jí)中學(xué)教育61普通高中畢業(yè)62普通高中結(jié)業(yè)63普通高中肄業(yè)70初級(jí)中學(xué)教育71初中畢業(yè)73初中肄業(yè)80小學(xué)教育81小學(xué)畢業(yè)83小學(xué)肄業(yè)90其他國(guó)籍/地區(qū)代碼Va1ue值01中國(guó)02中國(guó)香港澳門(mén)03中國(guó)臺(tái)灣04海外4.6證件類(lèi)型代碼Va1ue值01居民身份證03護(hù)照06港澳居民來(lái)往大陸通行證07臺(tái)灣居民來(lái)往大陸通行證4.7卡類(lèi)型代碼Va1ue值A(chǔ)5健康虛擬卡A6健康實(shí)體卡A2社保卡4.8通道類(lèi)別代碼Va1ue值1健康錢(qián)包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文檔說(shuō)明41.2讀者43術(shù)語(yǔ)約定4第2章接口規(guī)范41網(wǎng)絡(luò)通信方式42.2語(yǔ)法42.3接口報(bào)文約定42.4請(qǐng)求有效性驗(yàn)證算法6第3章支付平臺(tái)線上統(tǒng)一對(duì)賬接口定義說(shuō)明63.1支付訂單同步接口63.2退款訂單同步73.3商戶號(hào)校驗(yàn)83.4聚合支付明細(xì)查詢9第4章附錄104.1返回碼(retcode)104.2行政區(qū)代碼104.3性別代碼114.4職業(yè)代碼114.5文化程度114.6國(guó)籍/地區(qū)134.7證件類(lèi)型134.8卡類(lèi)型134.9通道類(lèi)別13第1章概述1.1文檔說(shuō)明1.2讀者本文檔的閱讀對(duì)象為app開(kāi)發(fā)人員1.3術(shù)語(yǔ)約定第2章接口規(guī)范2

6、.1網(wǎng)絡(luò)通信方式以http/https協(xié)議，服務(wù)器點(diǎn)對(duì)點(diǎn)post方式進(jìn)行數(shù)據(jù)通信2.2語(yǔ)法消息體采用XML格式描述，消息體的語(yǔ)法規(guī)則完全遵循XML語(yǔ)法規(guī)則，并嚴(yán)格區(qū)分大小寫(xiě)。2.3接口報(bào)文約定2.3.1接口通信地址接口地址:https:/*/gatewayOnline/gateway/portal/execute語(yǔ)法消息體采用XML格式描述，消息體的語(yǔ)法規(guī)則完全遵循XML語(yǔ)法規(guī)則，并嚴(yán)格區(qū)分大小寫(xiě)。每一個(gè)消息由一個(gè)消息頭和消息體構(gòu)成。其中消息是由一個(gè)完整的XML加密而來(lái)。一個(gè)完整的消息如下圖所示：消消息頭消息頭內(nèi)容息消息體業(yè)務(wù)要素1內(nèi)容體整個(gè)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)過(guò)DES加密后的字符串</Body></Data></Root>BODY原文如下<Data><HealthCardId>HealthCardId</HealthCardId><Signature>2113333334440</Signature><Data>2.3.2消息頭每一個(gè)會(huì)話或應(yīng)用消息有一個(gè)消息頭，該消息頭指明消息類(lèi)型

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

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

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

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

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

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

溫馨提示

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

評(píng)論

0/150

提交評(píng)論