车险API接口文档
接口地址
测试地址 http://testapi.rongstone.com/api
生产地址 http://api.rongstone.com/api
鉴权方法
HTTP头
| HTTP头名称 | 字段说明 | 样例 |
|---|---|---|
| timestamp | 时间戳 | 1490259359789 |
| signature | 签名字段 | 此字段为算法见下文 |
| 名称 | 字段说明 |
|---|---|
| timestamp | 13位时间戳，需要判断接收到的时间戳 是否在当前时间的前后30分钟，如果不是，将按照无效请求处理 |
| signature | String temp = MD5(token.upper() + "I" + timestamp).upper() |
| token | 令牌 上线前会给出 |
调用顺序
默认支付：搜索车型——>报价——>核保——>申请支付——>等待支付结果和承保结果
第三方支付：搜索车型——>报价——>核保——>申请支付——>支付校验——>（用户付款）——>支付请求——>等待支付结果和承保结果（如迟迟未到调用 受托请求 一般不用）
得到地区列表
Requestbody:
{
"project":"lsj2tpyjycx" //项目名称
}
Responsebody：
{
"statusCode": "000000", //状态代码 正常：000000
"error":"" //错误描述
"result": [{
"isopen": "true", //是否开通车险业务 开通：true 未开通：false
"partercode": "GX_1010100_001", //内部代码 不许考虑
"province": "北京", //省份
"city": "北京市", //城市
"plate": "京A", //车牌前缀
"proxy": "GXHT", //经代公司 国新汇通
"areacodeid": "110100" //区域代码
},
......
]
}
得到车辆来历凭证种类
Requestbody:
{
"project":"lsj2tpyjycx" //项目名称
}
Responsebody：
{
"statusCode": "000000", //状态代码 正常：000000
"error":"" //错误描述
"result": [{
"text": "销售发票", //种类名称
"value": "TYPE_01" //种类代码
},
......
]
}
得到民族信息
Requestbody:
{
"project":"lsj2tpyjycx" //项目名称
}
Responsebody：
{
"statusCode": "000000", //状态代码 正常：000000
"error":"" //错误描述
"result": [{
"text": "汉族", //民族名称
"value": "1" //民族代码
},
......
]
}
搜索车型信息
Requestbody:
{
"project":"lsj2tpyjycx" //项目名称
"randomno":"230d24cc36fc47789382865e3412e34a", //流水号 做报价 和核保的时候 会使用
"areacode":"110100", //区域代码
"plateno":"京NPJ123", //车牌号 新车为空
"engineno":"HK12312", //发动机号
"registdate":"2017-09-12", //车辆注册日期
"rackno":"LFMJV36F2C0022473", //车辆17位识别代码 VIN
"brandmodelname":"丰田TV6461GL", //车型信息
}
Responsebody：
{
"statusCode": "000000", //状态代码 正常：000000
"error":"" //错误描述
"result": [{
"vehiclecode": "FTAASD0027", //车型编码
"vehiclename": "丰田TV6461GLM多用途乘用车", //车型名称
"vehicleprice": 186800, //新车购置价
"vehicleseat": 5, //座位数
"vehiclestyle": "手动档 炫装版 四驱 国Ⅳ", //详细描述信息
"vehicleyear": "2012年03月", //年款
以下为 太保车型查询返回 不同保险公司 此处返回不同
"familyCode": "FTA1BC", //车系编码
"engineCapacity": "1.998", //排量
"gearboxType": "", //档位/变速箱类型
"vehicleAlias": "RAV4 2.0L MT炫装版四驱", //配置型号/车型别名
"purchasePrice": 186800, //新车购置价
"moldName": "丰田TV6461GLM多用途乘用车", //车型名称
"seatCount": 5, //座位数
"moldCharacterCode": "FTAASD0027",//车型编码
"producingArea": "0", //玻璃产地 0国产 1进口
"vehicleBrand": "天津一汽丰田", //车款/品牌名称
"yearPattern": "201203", //年款
"remark": "手动档 炫装版 四驱 国Ⅳ", //详细描述信息
"modelFlag": "", //行业车型编码标识 1:推荐车型，2:无推荐标志
},
......
]
}
报价
Requestbody:
{
"project":"lsj2tpyjycx" //项目名称
"randomno":"230d24cc36fc47789382865e3412e34a", //流水号 做报价 和核保的时候 会使用
"areacode":"110100", //区域代码
"isnewplate":"false", //是否是新车 true：新车 false：非新车
"istransfer":"true", //是否过户车 true：过户车 false：非过户车
"transferdate":"2013-08-21", //过户时间 过户车必填 非过户车为空
"isloan": "false", //是否贷款车
"plateno":"京NPJ123", //车牌号 新车为空
"engineno":"HK12312", //发动机号
"registdate":"2017-09-12", //车辆注册日期
"rackno":"LFMJV36F2C0022473", //车辆17位识别代码 VIN
"brandmodelname":"丰田TV6461GL", //车型信息
新车在京行驶 非京牌在京行驶 需要来历证明
"certificatetypecode":"", //来历凭证种类
"certificateno":"", //来历凭证号
"certificatedate":"", //来历凭证日期
新车行驶在上海 需要提供购车发票日期
"purchaseinvoicedate":"", //购车发票日期
在京行驶 电子保单 需要客户身份证信息
"owneridbegindate":"", //身份证 有效期起始时间
"owneridenddate":"", //身份证 有效期截止时间
"ownerpublish":"", //签发机构
"ownernation":"", //民族
在北京 深圳 厦门 天津 上海 行驶 需要 车主邮箱
"owneremail":"", //车主邮箱
"ownername":"姚明", //车主姓名
"ownermobile":"13812345678", //车主手机号码
"owneridcard":"110102200108082314", //车主身份证号码
"holdername":"姚明", //投保人姓名 空 自动填充为车主姓名
"holdermobile":"13812345678", //投保人手机号码 空 自动填充为车主手机号码
"holderidcard":"110102200108082314", //投保人身份证号码 空 自动填充为车主身份证号码
"insuredname":"姚明", //被保人姓名 空 自动填充为车主姓名
"insuredmobile":"13812345678", //被保人手机号码 空 自动填充为车主手机号码
"insuredidcard":"110102200108082314", //被保人身份证号码 空 自动填充为车主身份证号码
"businessstartdate":"" //商业险起保日期 可空 最早为第二天
"businessenddate":"" //商业险截止日期 可空
"trafficstartdate":"" //交强险起保日期 可空 最早为第二天
"trafficenddate":"" //交强险截止日期 可空
验证码信息
"checkcode":"" //转保车辆会有验证码
"vehiclecode": "FTAASD0027", //车型编码
"vehicle":
{
"vehiclecode": "FTAASD0027", //车型编码
"vehiclename": "丰田TV6461GLM多用途乘用车", //车型名称
"vehicleprice": 186800, //新车购置价
"vehicleseat": 5, //座位数
"vehiclestyle": "手动档 炫装版 四驱 国Ⅳ", //详细描述信息
"vehicleyear": "2012年03月" //年款
"familyCode": "FTA1BC", //车系编码
"engineCapacity": "1.998", //排量
"gearboxType": "", //档位/变速箱类型
"vehicleAlias": "RAV4 2.0L MT炫装版四驱", //配置型号/车型别名
"purchasePrice": 186800, //新车购置价
"moldName": "丰田TV6461GLM多用途乘用车",//车型名称
"seatCount": 5, //座位数
"moldCharacterCode": "FTAASD0027", //车型编码
"producingArea": "0", //玻璃产地 0国产 1进口
"vehicleBrand": "天津一汽丰田", //车款/品牌名称
"yearPattern": "201203", //年款
"remark": "手动档 炫装版 四驱 国Ⅳ", //详细描述信息
"modelFlag": "", //行业车型编码标识 1:推荐车型，2:无推荐标志
},
"coverage": {
"abatement_jqx": "0", //是否投保 交强险不计免赔 这里始终为0
"alternative_jqx": "0", //是否投保 交强险 0：不投保 1：投保
"abatement_carlosscoverage": "1", //是否投保 车损险不计免赔 0：不投保 1：投保
"alternative_carlosscoverage": "1", //是否投保 车损险 0：不投保 1：投保
"abatement_thirdpartycoverage": "1",//是否投保 第三者责任险不计免赔 0：不投保 1：投保
"alternative_thirdpartycoverage": "500000",//是否投保 第三者责任险 0：不投保 50000 100000 150000 200000 300000 500000 1000000 1500000 2500000 3000000 分别代表保额
"abatement_drivercoverage": "1", //是否投保 司机责任险不计免赔 0：不投保 1：投保
"alternative_drivercoverage": "10000", //是否投保 司机责任险 0：不投保 5000 10000 20000 30000 40000 50000 100000 200000 分别代表保额
"abatement_passengercoverage": "1", //是否投保 乘客责任险不计免赔 0：不投保 1：投保
"alternative_passengercoverage": "10000", //是否投保 乘客责任险 0：不投保 5000 10000 20000 30000 40000 50000 100000 200000 分别代表保额
"abatement_theftcoverage": "0", //是否投保 盗抢险不计免赔 0：不投保 1：投保
"alternative_theftcoverage": "0", //是否投保 盗抢险 0：不投保 1：投保
"abatement_enginewadingcoverage": "0", //是否投保 发动机涉水险不计免赔 0：不投保 1：投保
"alternative_enginewadingcoverage": "0", //是否投保 发动机涉水险 0：不投保 1：投保
"abatement_selfignitecoverage": "0",//是否投保 自燃险不计免赔 0：不投保 1：投保
"alternative_selfignitecoverage": "0", //是否投保 自燃险 0：不投保 1：投保
"abatement_carscrachcoverage": "0",//是否投保 车身划痕险不计免赔 0：不投保 1：投保 （太平洋保险 不保这项）
"alternative_carscrachcoverage": "0", //是否投保 车身划痕险 0：不投保 2000 5000 10000 20000 分别代表保额 （太平洋保险 不保这项）
"abatement_glassbrokencoverage": "0", //是否投保 玻璃破损险不计免赔 这里始终为0
"alternative_glassbrokencoverage": "0", //是否投保 玻璃破损险 0：不投保 1：投保
"abatement_appointrepaircoverage": "0", //是否投保 指定专修厂险不计免赔 这里始终为0
"alternative_appointrepaircoverage": "0", //是否投保 指定专修厂险 0：不投保 1：投保
"abatement_nothirdpartycoverage": "0", //是否投保 无法找到第三方险不计免赔 这里始终为0
"alternative_nothirdpartycoverage": "0", //是否投保 无法找到第三方险 0：不投保 1：投保
}
}
Responsebody：
{
"statusCode": "000000", //状态代码 正常：000000
"error":"" //错误描述
"result":
{
"randomno":"230d24cc36fc47789382865e3412e34a", //流水号
"ownername":"姚明", //车主姓名
"vehiclecode": "FTAASD0027", //车型编码
"businesspremium": 2000.23, //商业险费用
"trafficpremium": 665, //交强险费用
"taxpremium": 300, //车船税
"jqxpremium": 965, //交强险 + 车船税
"sumpremium": 2965.23, //总费用
"trafficstartdate":"2019-01-22", //交强险开始时间 未投保 为空
"trafficenddate":"2020-01-22", //交强险截止时间 未投保 为空
"businessstartdate":"2018-12-22", //商业险开始时间
"businessenddate":"2019-12-22", //商业险截止时间
验证码信息
"checkimage":"/9j/4AAQQABA....." //转保车辆会有验证码 这里是验证码图片 base64
"vehicle":
{
"vehiclecode": "FTAASD0027", //车型编码
"vehiclename": "丰田TV6461GLM多用途乘用车", //车型名称
"vehicleprice": 186800, //新车购置价
"vehicleseat": 5, //座位数
"vehiclestyle": "手动档 炫装版 四驱 国Ⅳ", //详细描述信息
"vehicleyear": "2012年03月", //年款
以下为 太保车型查询返回 不同保险公司 此处返回不同
"familyCode": "FTA1BC", //车系编码
"engineCapacity": "1.998", //排量
"gearboxType": "", //档位/变速箱类型
"vehicleAlias": "RAV4 2.0L MT炫装版四驱", //配置型号/车型别名
"purchasePrice": 186800, //新车购置价
"moldName": "丰田TV6461GLM多用途乘用车", //车型名称
"seatCount": 5, //座位数
"moldCharacterCode": "FTAASD0027",//车型编码
"producingArea": "0", //玻璃产地 0国产 1进口
"vehicleBrand": "天津一汽丰田", //车款/品牌名称
"yearPattern": "201203", //年款
"remark": "手动档 炫装版 四驱 国Ⅳ", //详细描述信息
"modelFlag": "", //行业车型编码标识 1:推荐车型，2:无推荐标志
},
"coverage":
{
"abatement_jqx": "0", //是否投保 交强险不计免赔 这里始终为0
"alternative_jqx": "0", //是否投保 交强险 0：不投保 1：投保
"abatement_carlosscoverage": "1", //是否投保 车损险不计免赔 0：不投保 1：投保
"alternative_carlosscoverage": "1",//是否投保 车损险 0：不投保 1：投保
"abatement_thirdpartycoverage": "1",//是否投保 第三者责任险不计免赔 0：不投保 1：投保
"alternative_thirdpartycoverage": "500000",//是否投保 第三者责任险 0：不投保 50000 100000 150000 200000 300000 500000 1000000 1500000 2500000 3000000 分别代表保额
"abatement_drivercoverage": "1", //是否投保 司机责任险不计免赔 0：不投保 1：投保
"alternative_drivercoverage": "10000",//是否投保 司机责任险 0：不投保 5000 10000 20000 30000 40000 50000 100000 200000 分别代表保额
"abatement_passengercoverage": "1",//是否投保 乘客责任险不计免赔 0：不投保 1：投保
"alternative_passengercoverage": "10000",//是否投保 乘客责任险 0：不投保 5000 10000 20000 30000 40000 50000 100000 200000 分别代表保额
"abatement_theftcoverage": "0",//是否投保 盗抢险不计免赔 0：不投保 1：投保
"alternative_theftcoverage": "0",//是否投保 盗抢险 0：不投保 1：投保
"abatement_enginewadingcoverage": "0",//是否投保 发动机涉水险不计免赔 0：不投保 1：投保
"alternative_enginewadingcoverage": "0",//是否投保 发动机涉水险 0：不投保 1：投保
"abatement_selfignitecoverage": "0",//是否投保 自燃险不计免赔 0：不投保 1：投保
"alternative_selfignitecoverage": "0",//是否投保 自燃险 0：不投保 1：投保
"abatement_carscrachcoverage": "0",//是否投保 车身划痕险不计免赔 0：不投保 1：投保 （太平洋保险 不保这项）
"alternative_carscrachcoverage": "0",//是否投保 车身划痕险 0：不投保 2000 5000 10000 20000 分别代表保额 （太平洋保险 不保这项）
"abatement_glassbrokencoverage": "0",//是否投保 玻璃破损险不计免赔 这里始终为0
"alternative_glassbrokencoverage": "0",//是否投保 玻璃破损险 0：不投保 1：投保
"abatement_appointrepaircoverage": "0",//是否投保 指定专修厂险不计免赔 这里始终为0
"alternative_appointrepaircoverage": "0",//是否投保 指定专修厂险 0：不投保 1：投保
"abatement_nothirdpartycoverage": "0",//是否投保 无法找到第三方险不计免赔 这里始终为0
"alternative_nothirdpartycoverage": "0",//是否投保 无法找到第三方险 0：不投保 1：投保1
"alternativepremium_jqx": 0, //交强险 保费
"alternativepremium_tax": 0, //车船税 保费
"alternativepremium_carlosscoverage": 713.3, //车损险 保费
"abatementpremium_carlosscoverage": 106.99,//车损险不计免赔 保费
"alternativepremium_thirdpartycoverage": 797.64,//第三者险 保费
"abatementpremium_thirdpartycoverage": 119.65,//第三者险不计免赔 保费
"alternativepremium_drivercoverage": 22.22,//司机责任险 保费
"abatementpremium_drivercoverage": 3.33,//司机责任险不计免赔 保费
"alternativepremium_passengercoverage": 56.36,//乘客责任险 保费
"abatementpremium_passengercoverage": 8.45,//乘客责任险不计免赔 保费
"alternativepremium_theftcoverage": 0,//盗抢险 保费
"abatementpremium_theftcoverage": 0,//盗抢不计免赔 保费
"alternativepremium_enginewadingcoverage": 0,//发动机涉水险 保费
"abatementpremium_enginewadingcoverage": 0,//发动机涉水险不计免赔 保费
"alternativepremium_selfignitecoverage": 0,//自燃险 保费
"abatementpremium_selfignitecoverage": 0,//自燃险不计免赔 保费
"alternativepremium_carscrachcoverage": 0,//车身划痕险 保费
"abatementpremium_carscrachcoverage": 0,//车身划痕险不计免赔 保费
"alternativepremium_glassbrokencoverage": 0,//玻璃破损险 保费
"abatementpremium_glassbrokencoverage": 0,//玻璃破损不计免赔 保费
"alternativepremium_appointrepaircoverage": 0,//指定专修厂险 保费
"abatementpremium_appointrepaircoverage": 0,//指定专修厂险不计免赔 保费
"alternativepremium_nothirdpartycoverage": 0,//无法找到第三方险 保费
"abatementpremium_nothirdpartycoverage": 0,//无法找到第三方险不计免赔 保费
"alternative_tax": "complete" //车船税状态 complete：已完税 normal：纳税 free：免税 discount：减税 refuse：拒缴 supplement：补税 uncertain：有争议
}
}
}
核保
Requestbody:
{
"randomno":"230d24cc36fc47789382865e3412e34a", //流水号
"dispatchname":"姚明", //收件人姓名
"dispatchmobile":"13812345678", //收件人手机号码
"dispatchaddress":"北京西城XXXXXX",//收件人地址
在京行驶 电子保单 需要客户身份证信息
"owneridbegindate":"", //身份证 有效期起始时间
"owneridenddate":"", //身份证 有效期截止时间
"ownerpublish":"", //签发机构
"ownernation":"", //民族代码
在北京 深圳 厦门 天津 上海 行驶 需要 车主邮箱
"owneremail":"", //车主邮箱
"holdername":"姚明", //投保人姓名 空 自动填充为车主姓名
"holdermobile":"13812345678", //投保人手机号码 空 自动填充为车主手机号码
"holderidcard":"110102200108082314",//投保人身份证号码 空 自动填充为车主身份证号码
"insuredname":"姚明", //被保人姓名 空 自动填充为车主姓名
"insuredmobile":"13812345678", //被保人手机号码 空 自动填充为车主手机号码
"insuredidcard":"110102200108082314",//被保人身份证号码 空 自动填充为车主身份证号码
验证码信息
"checkcode":"" //转保车辆会有验证码
}
Responsebody：
{
"statusCode": "000000", //状态代码 正常：000000
"error":"" //错误描述
"result":
{
"orderno":"12312321312312312", //订单号码
"trafficapplicationno":"2018-12-22",//交强险投保单号
"trafficpolicyno":"2019-12-22", //交强险保单号
"businessapplicationno":"2019-01-22",//商业险投保单号
"businesspolicyno":"2020-01-22", //商业险保单号
验证码信息
"checkimage":"/9j/4AAQQABA....." //转保车辆会有验证码 这里是验证码图片 base64
}
}
支付申请
Requestbody:
{
"orderno":"12312321312312312", //订单号码
"isdefaultpay":"false", //是否使用保险公司默认支付
"iswechat":"false", //保险公司支付 是否是 微信支付
"acceptanceResultUrl":"http://", //承保成功回调地址
"payResultUrl":"http://", //付款成功回调地址
}
response body
{
"statusCode":"000000", //状态码 6个0 为正确
"error":"" //错误描述
"result":"https://", //默认支付链接 当非默认支付 此项为空
支付校验
此接口 仅在 支付方式为 当非默认支付
在用户支付前进行校验
Requestbody:
{
"orderno":"12312321312312312", //订单号码
}
response body
{
"statusCode":"000000", //状态码 6个0 为正确
"error":"" //错误描述
"result":"ok"
}
支付请求
此接口 仅在 支付方式为 当非默认支付时
用户支付完成后 调用
Requestbody:
{
"orderno":"12312321312312312", //订单号码
"consumepayno":"12312321332", //第三方支付号
"consumepaytype":"alipay", //第三方支付方式 alipay：支付宝 wechatpay：微信网页 wxaccountpay：微信公众号支付 bankpay：银行支付
"consumeamount":2965.23, //第三方支付号
}
response body
{
"statusCode":"000000", //状态码 6个0 为正确
"error":"" //错误描述
"result":"ok"
}
受托支付请求
此接口 仅在 支付方式为 当非默认支付时
支付请求后 迟迟未得到支付成功回调 时 调用
Requestbody:
{
"orderno":"12312321312312312", //订单号码
}
response body
{
"statusCode":"000000", //状态码 6个0 为正确
"error":"" //错误描述
"result":"ok"
}
回调接口
支付成功回调
Requestbody:
{
"orderno":"12312321312312312", //订单号码
"result":"success", //支付结果 success fault
}
承保成功回调
Requestbody:
{
"orderno":"12312321312312312", //订单号码
"result":"success", //承保结果 success fault
}
