京东金融保险平台接口设计v

1、目录1引言. 101.1文档概述101.2阅读对象101.3更新历史102概述. 102.1交互模式102.2接口列表112.3数据类型132.4报文格式132.4.1请求报文132.4.2返回报文163接口定义. 173.1核保请求 .173.1.1请求数据 .173.1.2请求报文示例 .203.1.3返回数据 .223.1.4返回报文示例 .233.2核保回调 .233.2.1请求数据 .233.2.2请求报文示例 .243.2.3返回数据 .243.2.4返回报文示例 .243.3二次核保 .253.3.1请求数据 .253.3.2请求报文示例 .283.3.3返回数据 .303.3.

2、4返回报文示例 .303.4出单请求（承保） .313.4.1请求数据 .313.4.2请求报文示例 .313.4.3返回数据 .323.4.4返回报文示例 .333.5出单回调 .343.5.1请求数据 .343.5.2请求报文示例 .343.5.3返回数据 .353.5.4返回报文示例 .353.6状态.363.6.1请求数据 .363.6.2请求报文示例 .363.6.3返回数据 .363.6.4返回报文示例 .373.7保单价值.383.7.1请求数据 .383.7.2请求报文示例 .383.7.3返回数据 .393.7.4返回报文示例 .393.8退保费用核算 .403.8.1请求数

3、据 .403.8.2请求报文示例 .403.8.3返回数据 .413.8.4返回报文示例 .423.9退保请求 .423.9.1请求数据 .423.9.2请求报文示例 .433.9.3返回数据 .443.9.4返回报文示例 .443.10退保回调 .453.10.1请求数据 .453.10.2请求报文示例 .463.10.3返回数据 .473.10.4返回报文示例 .473.11退保资金划拨通知 .473.11.1请求数据 .473.11.2请求报文示例 .483.11.3返回数据 .493.11.4返回报文示例 .493.12保单确认通知（回访） .493.12.1请求数据 .493.12.

4、2请求报文示例 .493.12.3返回数据 .503.12.4返回报文示例 .503.13保单确认通知回调 .503.13.1请求数据 .503.13.2请求报文示例 .503.13.3返回数据 .513.13.4返回报文示例 .513.14出单.513.14.1请求数据 .513.14.2请求报文示例 .513.14.3返回数据 .523.14.4返回报文示例 .523.15退保资金划拨通知回调 .533.15.1请求数据 .533.15.2请求报文示例 .533.15.3返回数据 .543.15.4返回报文示例 .543.16京东通知保险公司退款 .543.16.1请求数据 .543.16

5、.2请求报文示例 .553.16.3返回数据 .553.16.4返回报文示例 .563.17京东通知保险公司退款回调 .563.17.1请求数据 .563.17.2请求报文示例 .573.17.3返回数据 .573.17.4返回报文示例 .573.18保费追加 (保全) .583.18.1请求数据 .583.18.2请求报文示例 .583.18.3返回数据 .593.18.4返回报文示例 .603.19保费追加回调(保全) .603.19.1请求数据 .603.19.2请求报文示例 .613.19.3返回数据 .623.19.4返回报文示例 .623.20活期转定期 .623.20.1请求信息

6、 .623.20.2请求报文示例 .633.20.3返回数据 .643.20.4返回报文事例 .643.21活期转定期回调 .653.21.1请求数据 .653.21.2请求报文示例 .663.21.3返回数据 .673.21.4返回报文示例 .673.22定期到期通知 .673.22.1请求数据 .673.22.2请求报文事例 .683.22.3返回数据 .683.22.4返回报文示例 .693.23当前率.693.23.1请求数据 .693.23.2请求报文示例 .693.23.3返回数据 .703.23.4返回报文示例 .703.24保费追加核保 .713.24.1请求数据 .713.2

7、4.2请求报文示例 .713.24.3返回数据 .723.24.4返回报文示例 .724地区编码. 734.1北京 .734.2上海 .734.3.734.4重庆 .734.1河北 .744.2山西 .744.3内.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订单状态886通用字段定义887第支付机构/编码927.1第支付机构编码927.2编码938附录. 94文档修订修订日期修订内容修订版本修订人2014-04-22文档创建，编撰接口列表和相关内容1.0.0赖韬2014-04-23整合常会永、吴武桓定义接口内容1.0.0赖韬2014-04-25新增出单接口，修改不一样的错误码1.1.0赖韬2014-04-28更新安全机制，对整个 XML 报文先进行 BASE64 编码，然后做 MD5 生成摘要1.1.1赖韬2014-04-29增加地区编码1.1.2杨涛2014-05-271、修改部分接口参数，重新修改核保接口

9、2、增加部分常量和枚举定义3、移除京东投保单号定义，统一使用京东金融订单号1.1.3赖韬2014-05-291、核保接口增加 Pin 参数2、出单接口增加支付枚举，持卡人姓名等信息3、退保接口和退保回调接口增加保全类型参数1.1.4赖韬2014-06-051、确定 ResponseCode 的值，0 表示，非 0 表示失败2、确定 UnderWriteCode 的值，0 表示；非 0 表示失败或异常3、将布尔值类型统一修改为 true 和 false 4、增加退保资金划拨通知回调接口5、增加京东通知保险公司退款接口6、增加京东通知保险公司退款回调接口1.1.5赖韬2014-06-131、将 A

10、mont 修改为 Amount2、确定 ResponseCode 的值，0 表示，1 表示处理中， 其他表示失败或异常3、增加京东第支付机构/编码1.1.6赖韬2014-07-041、退保请求接口保全类型增加枚举值定义1.1.7赖韬2014-8-121、 活期转定期2、 定期到期通知1.1.8杨涛2014-9-111、 保费追加(保全)1.1.9杨涛、郭海瑞2、 保费追加回调(保全)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 出单回调接口，增加保单到期日（FinancialMaturity）字段1.2.1闵祥飞2015-7-141、3.9 及 3.10 接口，增加返回 Fee 手续费字段，必输1.2.2闵祥飞1 引言1.1文档概述本文描述了内部和外部需求接入京东金融保险平台的接口设计。1.2阅读对象京东经理，开发，测试。保险公司经理，开发，测试。1.3更新历史2 概述2.1交互模式属性说明交互协议HTTP/HTTPS数据格式XML 标准格式传参方式POSTGET 参数POST 参数整个 XML 报文序号更新日期更新内容概述提交人12014-09-26增加核保请求 QnResult

12、字段郭海瑞2.2接口列表接口名称类型发起方描述核保请求01京东京东将投保信息传送给保险公司进行核保，保险公司将核保结果同步或者异步返回核保回调02保险公司保险公司核保后，将核保结果返回京东（只适用于异步模式）二次核保03京东对于核保通过并且超过指定时间没有支付的订单，在用户支付前将投保信息再次给保险公司，进行保费和时间等信息的校验，保险公司即时返回校验结果出单请求（承保）04京东用户在对已核保订单进行支付后，京东将支付给保险公司，保险公司进行出单操作，以同步或者异步的方式将出单结果反馈京东出单回调05保险公司保险公司在接到出单请求后，将结果返回京东（只适用于异步模式）状态06京东保险公司提供订

13、单接口，京东可以通过订单号所对应保单在保险公司的状态保单价值07京东保险公司提供保单接口，京东可以通过订单号所应答模式支持同步与异步安全机制1、报文加密机制：(1)、整个 XML 报文 BASE64（2）按照京东与保险公司约定的 KEY，对整个 XML 报文 BASE64 编码后，进行 MD5 生成一个摘要，规则如下：Sign=Md5(Base64(xml) + key);测试环境 KEY：1234562、用户卡信息加密规则：采用 AES 加密方式，测试环境密钥：0123456789ABCDEF对应保单在保险公司的保单价值退保费用核算08京东京东将用户输入的赎回或退保金额等给保险公司，保险公司

14、扣除相应的手续费后，返回可以实际到帐的金额退保请求09京东京东将退保给保险公司进行审核，保险公司将退保结果同步或者异步返回退保回调10保险公司保险公司对京东过去的退保请求信息审核完成后，将本次的审核结果返回给京东（只适用于异步模式）退保资金划拨通知11京东京东接收到完成退保资金划拨消息后，会将资金划拨的结果通知到保险公司保单确认通知（回访）12京东用户在京东金确认保单后，将确认结果告知保险公司保单确认通知回调13保险公司用户在保险公司确认保单后，将确认结果告知京东金融平台出单14京东根据投保单号保险公司是否已经出单退保资金划拨通知回调15保险公司退保时，保险公司给用户退款后，需要将退款结果通知

15、回调给京东京东通知保险公司退款16京东京东发起的非退保退款操作，例如用户重复支付且后，主动通知保险公司进行退款操作京东通知保险公司退款回调17保险公司保险公司完成非退保退款后，将退款结果通知回调给京东保全(追加)18京东用户在京东非首次追加保费，京东将上送保险公司保全回调19保险公司保险公司保单追加费用后，将主动通知京东活期转定期20京东用户发起活期转定期，保险公司同步或异步返回活期转定期回调21保险公司保险公司活期转定期完成以后，主动通知京东结果定期到期通知22保险公司保险公司定期到期后，主动通知京东后续处理方式、结果当前率23京东某保险单的当前率保费追加核保24京东保单保费追加前的验证，验

16、证通过，可以追加保费2.3数据类型2.4报文格式2.4.1 请求报文请求报文包括京东主动发起的报文以及保险公司主动发起的报文（如核保、出单异步模式下的回调）。请求报文的报文头是固定的，京东请求与保险公司请求头信息略有不同。京东发起请求报文头信息如下：报文块说明部分以<?xml version="1.0" encoding="UTF-8"?>为格式根节点以<PackageList>为起始标记，以</PackageList>为结束标记。可以包含多个<Package>节点报文根以<Package>为起

17、始标记，以</Package>为结束标记报文头以<Header>为起始标记，以</Header>为结束标记报文体以<Request>或<Response>为起始标记，以</Request>或</Response>为结束标记。(京东请求用<Request>，保险公司请求用<Callback>，应答方用<Response>)类型说明字符 String阿德布尔 BooleanTrue or false时间 Datetime2014-04-22 16:45:00枚举 Enum01,0

18、2数值 Num123京东发起请求报文示例：<?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保险公司发起时，必填8Asyn是否异步接口布尔N缺省值 false，表示同步9ReturnUrl回调 Url字符N10ProductCode险种编码字符N保险公司发起请求报文头信息如下：保险公司发起请求报文示例：<?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 返回报文请求返回报文包括京东发起保险公司响应的报文，也包括保险公司发起京东回复的报文。两者的报文头格式相同。对于异步请求的返回报文，仅包括数据头部分；对于同步请求的返回报文，可能还包括一些业务

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