一、文档概述

新概念API开发文档为合作方提供统一接口交互协议、报文格式,方便各个合作方接入和开发。合作方按需查看并下载对应接入文档。

二、文档类型

1、页面(H5)接入数据回传文档

对于页面(H5)接入的合作方,可按需查看并下载该文档。该文档可方便合作方的技术伙伴接收新概念的数据回调。

想要下载文档?点击这里

2、API对接文档

该文档为新概念统一对外提供的API接入文档,包含核保、承保、查询、退保接口,涉及多家保险公司接口。合作方可根据具体产品接入以上接口。

想要下载文档?点击这里

3、支付对接文档

对于接入纯支付(不涉及产品)的合作方,按支付文档要求接入并请求,新概念返回合作方支付链接完成支付交易。

想要下载文档?点击这里

一、新概念测试环境说明

测试环境
对接账号 新概念提供
产品代码 (API接入) 新概念提供
秘钥 (同支付) e77b2bf7637f86d352cea39d93fd13c8
请求地址 http://sit.xgnins.com/InsuranceApi_web/platformApi.do

二、新概念生产环境说明

****生产环境需要在测试通过后提供

三、新概念网关说明

新概念接口网关是向开发者提供安全、可靠、快速的接入服务。把内部服务API开放给开发者的工具组件。在这中间为了交互安全,开发者需向新概念提供 测试环境(开发)IP地址 (可多个)以及生产环境IP地址(可多个)配置白名单策略,否则将无权限接入。

一、页面接入说明

页面(H5)接入模式可满足快速上线,合作方不需要开发产品的前端展示页面,只需要提供该保险产品的入口,用户点击右新概念提供的产品链接后直接跳转新概念开发的产品展示页,极大的节约合作方的开发成本。

该模式主要有以下特点:

1.支持合作方在PC端、移动端(公众号)嵌入产品链接,用户点击实现交易

2.合作方可按需申请回调(回调地址由合作方提供)用户投保信息以及承包信息

3.合作方可在开放平台查看订单数据

二、页面接入流程

三、页面接入流程

产品链接实例: https://m.xgnins.com/product-web/details?productId=155&comId=XXX&extendData=XXX

参数说明:

comId:由新概念分配给合作方的专属标识

productId:产品编号

extendData:拓展字段,可由合作方在产品拼接后拼接,数据回调时原样返回

四、文档下载

  • H5数据回传文档 V1.0.0

    更新于 2019.01.21

    下载文档

一、交互模式

属性 说明
交互协议 HTTP
数据格式 XML
传输方式 POST
编码 UTF-8
POST参数

comid: 新概念提供;

data: BASE64(请求报文);

sign: md5(data+key)

使用BASE64编码数据和新概念分配的秘钥key进行md5加密;

响应方式 同步
安全机制 报文加密机制: 使用新概念分配的秘钥key,对整个XML报文BASE64编码后,再进行MD5生成一个摘要。

规则如下:sign=MD5(BASE64(XML)+key)

安全验证 需要提供服务器IP配置白名单策略
支付 需提供支付成功跳转地址和异步通知地址
幂等性 服务方可以重复接收内容相同的请求,并返回相同的处理结果

*请求实例可下载API对接SDK参考

二、接口列表

接口名称 交易类型 发起方 描述
核保 01 合作方 用户购买保障型保险时,由合作方向新概念发起核保,新概念返回核保结果信息。
承保 02 合作方 用户购买保障型保险核保付款成功后,由合作方发起的承保出单请求。
查询 03 合作方 用户购买保障型保承保成功后,由合作方发起的查询保单请求。
撤单 04 合作方 用户购买保障型保承保成功后,由合作方发起的撤销保单请求。
支付接口 合作方 该接口只适用于新概念产品。

三、请求流程

1、新概念产品API接口对接请求流程:

核保-->支付(新概念支付)-->承保-->撤单

2、非新概念产品API接口对接请求流程:

非见费出单:核保-->承保-->撤单

见费出单:核保-->支付(保险公司支付)-->承保(异步返回)-->撤单

**注:非新概念产品API接口对接流程并非绝对,具体视产品而定。

四、文档下载

一、交互模式

属性 说明
交互协议 HTTP
数据格式 JSON
传输方式 POST
编码 UTF-8
POST参数

comid: 新概念提供;

data: BASE64(请求报文);

sign: md5(data+key)

使用BASE64编码数据和新概念分配的秘钥key进行md5加密;

响应方式 同步
安全机制 报文加密机制: 使用新概念分配的秘钥key,对整个JSON报文BASE64编码后,再进行MD5生成一个摘要。规则如下。

规则如下:sign=MD5(BASE64(JSON)+key)

安全验证 需要提供服务器IP配置白名单策略
支付 需提供支付成功跳转地址和异步通知地址

*请求实例可下载支付对接SDK参考

二、新概念支付回调方式

属性 说明
交互协议 HTTP
数据格式 JSON
传输方式 POST
POST参数

comid: 新概念提供;

data: BASE64(请求报文);

sign: md5(data+key)

使用BASE64编码数据和新概念分配的秘钥key进行md5加密;

注:回调接入方,若接入方处理成功,须将”success”字符串返回给新概念,若不返回”success”字符串,则系统会持续回调。(回调频率为 15s 3m 10m 30m 1h 2h)

四、文档下载

  • 1、网关限制
    对接均需提供IP地址配置白名单策略。
  • 2、传输方式
    支持HTTP方式也支持HTTPS方式。
  • 3、请求方式
    API对接或支付对接均采用POST提交方式。
  • 4、字符编码
    统一UTF-8编码,字符区分大小写。
  • 5、数据格式
    API对接为XML数据格式,支付为JSON数据格式。
  • 6、签名算法
    MD5(Message-DigestAlgorithm5)算法。
  • 7、签名要求
    API接入、支付接入以及回调合作方均需要校验签名,具体参看SDK文件。
  • 1、FromSerial、GroupFromSerial和OrderId三者有什么区别?
    FromSerial为合作方订单号与OrderId相同,GroupFromSerial用于合并多个FromSerial,通常三者可相等。
  • 2、请求成功的标志是ResponseCode还是IsSuccess?
    返回ResponseCode为0000只表示新概念接收请求成功并处理了该请求,请求成功与否主要看返回IsSuccess是否为0000。
  • 3、为什么请求核保请求就返回了保单号和电子保单链接?
    核保接口返回保单号取决于保险公司接口,具体视产品及接口而定。
  • 4、API文档中的支付接口与支付文档中的支付接口有什么不同?
    API文档中的支付接口针对的是合作方接入新概念的产品使用新概念支付,支付文档中的支付接口与产品无关,只与支付相关。
  • 5、支付回调解析data为什么中文乱码了?
    接收到支付回调data,可先使用URLDecoder.decode(data)处理再进行base64解码。
  • 1、渠道ID
    即comId,生产环境由新概念分配,用于唯一标识合作方。
  • 2、秘钥key
    由新概念分配,双方均使用相同秘钥校验保证数据传输安全。
  • 3、投保单号
    由核保接口返回,保险公司生成(有的产品不返回),标识保险公司核保通过。
  • 4、保单号
    由保险公司生成,承保成功后必返回,退保时必须要有保单号。
  • 5、见费出单
    必须先完成投保交易,再缴费,最后完成承保交易,一次出单需要完成多个步骤。
  • 6、非见费出单
    一次交易完成出单的流程,包括投保、承保流程,此时尚未缴费。(仅限有代收保费资质机构)

接入方可查看并下载API对接SDK 或支付对接SDK(均为JAVA版本),合作方可参考此SDK调试新概念API接口或支付接口。

  • API-SDK V1.0.0

    更新于 2019.01.21

    下载SDK

  • PAY-SDK V1.0.0

    更新于 2020.05.19

    下载SDK

新概念订单号(OrderId) 商户订单号(FromSerial) 查询
报错信息返回结果: