京東金融保險平臺接口設(shè)計v

1、目錄1引言. 101.1文檔概述101.2閱讀對象101.3更新歷史102概述. 102.1交互模式102.2接口列表112.3數(shù)據(jù)類型132.4報文格式132.4.1請求報文132.4.2返回報文163接口定義. 173.1核保請求 .173.1.1請求數(shù)據(jù) .173.1.2請求報文示例 .203.1.3返回數(shù)據(jù) .223.1.4返回報文示例 .233.2核?；卣{(diào) .233.2.1請求數(shù)據(jù) .233.2.2請求報文示例 .243.2.3返回數(shù)據(jù) .243.2.4返回報文示例 .243.3二次核保 .253.3.1請求數(shù)據(jù) .253.3.2請求報文示例 .283.3.3返回數(shù)據(jù) .303.3.

2、4返回報文示例 .303.4出單請求（承保） .313.4.1請求數(shù)據(jù) .313.4.2請求報文示例 .313.4.3返回數(shù)據(jù) .323.4.4返回報文示例 .333.5出單回調(diào) .343.5.1請求數(shù)據(jù) .343.5.2請求報文示例 .343.5.3返回數(shù)據(jù) .353.5.4返回報文示例 .353.6狀態(tài).363.6.1請求數(shù)據(jù) .363.6.2請求報文示例 .363.6.3返回數(shù)據(jù) .363.6.4返回報文示例 .373.7保單價值.383.7.1請求數(shù)據(jù) .383.7.2請求報文示例 .383.7.3返回數(shù)據(jù) .393.7.4返回報文示例 .393.8退保費用核算 .403.8.1請求數(shù)

3、據(jù) .403.8.2請求報文示例 .403.8.3返回數(shù)據(jù) .413.8.4返回報文示例 .423.9退保請求 .423.9.1請求數(shù)據(jù) .423.9.2請求報文示例 .433.9.3返回數(shù)據(jù) .443.9.4返回報文示例 .443.10退?；卣{(diào) .453.10.1請求數(shù)據(jù) .453.10.2請求報文示例 .463.10.3返回數(shù)據(jù) .473.10.4返回報文示例 .473.11退保資金劃撥通知 .473.11.1請求數(shù)據(jù) .473.11.2請求報文示例 .483.11.3返回數(shù)據(jù) .493.11.4返回報文示例 .493.12保單確認通知（回訪） .493.12.1請求數(shù)據(jù) .493.12.

4、2請求報文示例 .493.12.3返回數(shù)據(jù) .503.12.4返回報文示例 .503.13保單確認通知回調(diào) .503.13.1請求數(shù)據(jù) .503.13.2請求報文示例 .503.13.3返回數(shù)據(jù) .513.13.4返回報文示例 .513.14出單.513.14.1請求數(shù)據(jù) .513.14.2請求報文示例 .513.14.3返回數(shù)據(jù) .523.14.4返回報文示例 .523.15退保資金劃撥通知回調(diào) .533.15.1請求數(shù)據(jù) .533.15.2請求報文示例 .533.15.3返回數(shù)據(jù) .543.15.4返回報文示例 .543.16京東通知保險公司退款 .543.16.1請求數(shù)據(jù) .543.16

5、.2請求報文示例 .553.16.3返回數(shù)據(jù) .553.16.4返回報文示例 .563.17京東通知保險公司退款回調(diào) .563.17.1請求數(shù)據(jù) .563.17.2請求報文示例 .573.17.3返回數(shù)據(jù) .573.17.4返回報文示例 .573.18保費追加 (保全) .583.18.1請求數(shù)據(jù) .583.18.2請求報文示例 .583.18.3返回數(shù)據(jù) .593.18.4返回報文示例 .603.19保費追加回調(diào)(保全) .603.19.1請求數(shù)據(jù) .603.19.2請求報文示例 .613.19.3返回數(shù)據(jù) .623.19.4返回報文示例 .623.20活期轉(zhuǎn)定期 .623.20.1請求信息

6、 .623.20.2請求報文示例 .633.20.3返回數(shù)據(jù) .643.20.4返回報文事例 .643.21活期轉(zhuǎn)定期回調(diào) .653.21.1請求數(shù)據(jù) .653.21.2請求報文示例 .663.21.3返回數(shù)據(jù) .673.21.4返回報文示例 .673.22定期到期通知 .673.22.1請求數(shù)據(jù) .673.22.2請求報文事例 .683.22.3返回數(shù)據(jù) .683.22.4返回報文示例 .693.23當前率.693.23.1請求數(shù)據(jù) .693.23.2請求報文示例 .693.23.3返回數(shù)據(jù) .703.23.4返回報文示例 .703.24保費追加核保 .713.24.1請求數(shù)據(jù) .713.2

7、4.2請求報文示例 .713.24.3返回數(shù)據(jù) .723.24.4返回報文示例 .724地區(qū)編碼. 734.1北京 .734.2上海 .734.3.734.4重慶 .734.1河北 .744.2山西 .744.3內(nèi).744.4廣西 .754.5遼寧 .764.6吉林 .764.7黑龍江 .774.8江蘇 .774.9浙江 .784.10.784.11福建 .794.12江西 .794.13山東 .804.14河南 .804.15.814.16湖南 .814.17.824.18海南 .824.19.834.20.844.21云南 .844.22.854.23陜西 .854.24.864.25.8

8、64.26青海 .864.27.875訂單狀態(tài)886通用字段定義887第支付機構(gòu)/編碼927.1第支付機構(gòu)編碼927.2編碼938附錄. 94文檔修訂修訂日期修訂內(nèi)容修訂版本修訂人2014-04-22文檔創(chuàng)建，編撰接口列表和相關(guān)內(nèi)容1.0.0賴韜2014-04-23整合常會永、吳武桓定義接口內(nèi)容1.0.0賴韜2014-04-25新增出單接口，修改不一樣的錯誤碼1.1.0賴韜2014-04-28更新安全機制，對整個 XML 報文先進行 BASE64 編碼，然后做 MD5 生成摘要1.1.1賴韜2014-04-29增加地區(qū)編碼1.1.2楊濤2014-05-271、修改部分接口參數(shù)，重新修改核保接口

9、2、增加部分常量和枚舉定義3、移除京東投保單號定義，統(tǒng)一使用京東金融訂單號1.1.3賴韜2014-05-291、核保接口增加 Pin 參數(shù)2、出單接口增加支付枚舉，持卡人姓名等信息3、退保接口和退?；卣{(diào)接口增加保全類型參數(shù)1.1.4賴韜2014-06-051、確定 ResponseCode 的值，0 表示，非 0 表示失敗2、確定 UnderWriteCode 的值，0 表示；非 0 表示失敗或異常3、將布爾值類型統(tǒng)一修改為 true 和 false 4、增加退保資金劃撥通知回調(diào)接口5、增加京東通知保險公司退款接口6、增加京東通知保險公司退款回調(diào)接口1.1.5賴韜2014-06-131、將 A

10、mont 修改為 Amount2、確定 ResponseCode 的值，0 表示，1 表示處理中， 其他表示失敗或異常3、增加京東第支付機構(gòu)/編碼1.1.6賴韜2014-07-041、退保請求接口保全類型增加枚舉值定義1.1.7賴韜2014-8-121、 活期轉(zhuǎn)定期2、 定期到期通知1.1.8楊濤2014-9-111、 保費追加(保全)1.1.9楊濤、郭海瑞2、 保費追加回調(diào)(保全)2015-4-31、 新增保費追加核保接口2、 保費追加接口修改1.1.9閔祥飛2015-6-111、3.9 及 3.10 接口，保全類型 EdorAcceptType 字段字段修改1.2.0閔祥飛2015-6-2

11、41、3.4 出單接口及 3.5 出單回調(diào)接口，增加保單到期日（FinancialMaturity）字段1.2.1閔祥飛2015-7-141、3.9 及 3.10 接口，增加返回 Fee 手續(xù)費字段，必輸1.2.2閔祥飛1 引言1.1文檔概述本文描述了內(nèi)部和外部需求接入京東金融保險平臺的接口設(shè)計。1.2閱讀對象京東經(jīng)理，開發(fā)，測試。保險公司經(jīng)理，開發(fā)，測試。1.3更新歷史2 概述2.1交互模式屬性說明交互協(xié)議HTTP/HTTPS數(shù)據(jù)格式XML 標準格式傳參方式POSTGET 參數(shù)POST 參數(shù)整個 XML 報文序號更新日期更新內(nèi)容概述提交人12014-09-26增加核保請求 QnResult

12、字段郭海瑞2.2接口列表接口名稱類型發(fā)起方描述核保請求01京東京東將投保信息傳送給保險公司進行核保，保險公司將核保結(jié)果同步或者異步返回核?；卣{(diào)02保險公司保險公司核保后，將核保結(jié)果返回京東（只適用于異步模式）二次核保03京東對于核保通過并且超過指定時間沒有支付的訂單，在用戶支付前將投保信息再次給保險公司，進行保費和時間等信息的校驗，保險公司即時返回校驗結(jié)果出單請求（承保）04京東用戶在對已核保訂單進行支付后，京東將支付給保險公司，保險公司進行出單操作，以同步或者異步的方式將出單結(jié)果反饋京東出單回調(diào)05保險公司保險公司在接到出單請求后，將結(jié)果返回京東（只適用于異步模式）狀態(tài)06京東保險公司提供訂

13、單接口，京東可以通過訂單號所對應(yīng)保單在保險公司的狀態(tài)保單價值07京東保險公司提供保單接口，京東可以通過訂單號所應(yīng)答模式支持同步與異步安全機制1、報文加密機制：(1)、整個 XML 報文 BASE64（2）按照京東與保險公司約定的 KEY，對整個 XML 報文 BASE64 編碼后，進行 MD5 生成一個摘要，規(guī)則如下：Sign=Md5(Base64(xml) + key);測試環(huán)境 KEY：1234562、用戶卡信息加密規(guī)則：采用 AES 加密方式，測試環(huán)境密鑰：0123456789ABCDEF對應(yīng)保單在保險公司的保單價值退保費用核算08京東京東將用戶輸入的贖回或退保金額等給保險公司，保險公司

14、扣除相應(yīng)的手續(xù)費后，返回可以實際到帳的金額退保請求09京東京東將退保給保險公司進行審核，保險公司將退保結(jié)果同步或者異步返回退?；卣{(diào)10保險公司保險公司對京東過去的退保請求信息審核完成后，將本次的審核結(jié)果返回給京東（只適用于異步模式）退保資金劃撥通知11京東京東接收到完成退保資金劃撥消息后，會將資金劃撥的結(jié)果通知到保險公司保單確認通知（回訪）12京東用戶在京東金確認保單后，將確認結(jié)果告知保險公司保單確認通知回調(diào)13保險公司用戶在保險公司確認保單后，將確認結(jié)果告知京東金融平臺出單14京東根據(jù)投保單號保險公司是否已經(jīng)出單退保資金劃撥通知回調(diào)15保險公司退保時，保險公司給用戶退款后，需要將退款結(jié)果通知

15、回調(diào)給京東京東通知保險公司退款16京東京東發(fā)起的非退保退款操作，例如用戶重復(fù)支付且后，主動通知保險公司進行退款操作京東通知保險公司退款回調(diào)17保險公司保險公司完成非退保退款后，將退款結(jié)果通知回調(diào)給京東保全(追加)18京東用戶在京東非首次追加保費，京東將上送保險公司保全回調(diào)19保險公司保險公司保單追加費用后，將主動通知京東活期轉(zhuǎn)定期20京東用戶發(fā)起活期轉(zhuǎn)定期，保險公司同步或異步返回活期轉(zhuǎn)定期回調(diào)21保險公司保險公司活期轉(zhuǎn)定期完成以后，主動通知京東結(jié)果定期到期通知22保險公司保險公司定期到期后，主動通知京東后續(xù)處理方式、結(jié)果當前率23京東某保險單的當前率保費追加核保24京東保單保費追加前的驗證，驗

16、證通過，可以追加保費2.3數(shù)據(jù)類型2.4報文格式2.4.1 請求報文請求報文包括京東主動發(fā)起的報文以及保險公司主動發(fā)起的報文（如核保、出單異步模式下的回調(diào)）。請求報文的報文頭是固定的，京東請求與保險公司請求頭信息略有不同。京東發(fā)起請求報文頭信息如下：報文塊說明部分以<?xml version="1.0" encoding="UTF-8"?>為格式根節(jié)點以<PackageList>為起始標記，以</PackageList>為結(jié)束標記?？梢园鄠€<Package>節(jié)點報文根以<Package>為起

17、始標記，以</Package>為結(jié)束標記報文頭以<Header>為起始標記，以</Header>為結(jié)束標記報文體以<Request>或<Response>為起始標記，以</Request>或</Response>為結(jié)束標記。(京東請求用<Request>，保險公司請求用<Callback>，應(yīng)答方用<Response>)類型說明字符 String阿德布爾 BooleanTrue or false時間 Datetime2014-04-22 16:45:00枚舉 Enum01,0

18、2數(shù)值 Num123京東發(fā)起請求報文示例：<?xml version="1.0" encoding="UTF-8"?><PackageList><Package><Header><RequestType>01</RequestType><UUID>78</UUID><ComId>123456</ComId><SourceId></SourceId><SendTime>2014-04-22 18:00:

19、00</SendTime><JDSerial>1234567890</JDSerial><ComSerial></ComSerial><Asyn>false</ Asyn><ReturnUrl></ReturnUrl><ProductCode>123456</ProductCode></Header><Request>No.字段字段名類型必傳備注1RequestType類型枚舉Y見 2.2類型2UUID唯一標識字符Y3ComId保險公司編碼

20、枚舉Y4SourceId方編碼枚舉Y5SendTime時間時間Yyyyy-MM-dd HH:mm:ss6JDSerial京東流水號字符Y京東金融訂單號7ComSerial保險公司流水號字符N保險公司發(fā)起時，必填8Asyn是否異步接口布爾N缺省值 false，表示同步9ReturnUrl回調(diào) Url字符N10ProductCode險種編碼字符N保險公司發(fā)起請求報文頭信息如下：保險公司發(fā)起請求報文示例：<?xml version="1.0" encoding="UTF-8"?><PackageList><Package>&

21、lt;Header><RequestType>01</RequestType><UUID>78</UUID><ComId>123456</ComId><SourceId></SourceId><SendTime>2014-04-22 18:00:00</SendTime><JDSerial>1234567890</JDSerial><ComSerial></ComSerial></Header><Call

22、back>No.字段字段名類型必傳備注1RequestType類型枚舉Y見 2.2類型2UUID唯一標識字符Y3ComId保險公司編碼枚舉Y4SourceId方編碼枚舉Y5SendTime時間時間Y6JDSerial京東流水號字符Y京東金融訂單號7ComSerial保險公司流水號字符N</Request></Package></PackageList>2.4.2 返回報文請求返回報文包括京東發(fā)起保險公司響應(yīng)的報文，也包括保險公司發(fā)起京東回復(fù)的報文。兩者的報文頭格式相同。對于異步請求的返回報文，僅包括數(shù)據(jù)頭部分；對于同步請求的返回報文，可能還包括一些業(yè)務(wù)

23、反饋。返回報文頭信息如下：返回報文示例：<?xml version="1.0" encoding="UTF-8"?><PackageList><Package><Header><RequestType>01</RequestType><UUID>78</UUID>No.字段字段名類型必傳備注1RequestType類型枚舉Y見 2.2類型2UUID唯一標識字符Y3ComId保險公司編碼枚舉Y4SourceId方編碼枚舉Y5SendTime時間時間Y6JDSerial京東流水號字符Y京東金融訂單號7ComSerial保險公司流水號字符N