接口概述
适用于分销渠道通过自有资源,销售星灿保代代理的保险产品。通过该接口实现线上核保、出单。
1、分销渠道将投保信息,通过星灿保代传送给保险公司进行核保,保险公司将核保结果同步返回。核保成功后,用户才可以支付保费。
2、用户在对已核保成功订单进行支付后,分销渠道将支付信息通过星灿保代发送给保险公司,保险公司进行出单操作,以同步的方式将出单结果反馈星灿和分销渠道。
请求数据
请求信息(requestInfo):
No. |
字段 |
字段名 |
类型 |
必传 |
备注 |
1 |
underWrite |
核保 |
字符 |
N |
0:不传;1:核保;2:只保存信息不请求保险公司核保;为空默认为0 |
2 |
payment |
支付 |
字符 |
N |
0:不传;1:分销渠道支付;2:保险支付;为空默认为0 |
3 |
insure |
出单 |
字符 |
N |
0:不传;1:出单;2:一键出单;为空默认为0 |
4 |
syn |
是否同步 |
字符 |
Y |
0:异步;1:同步 |
5 |
callbackUrl |
回调通知url |
字符 |
N |
异步不为空;如返回方式为异步,则需要对接《核保、支付、出单异步通知接口》 |
保险信息(insuranceInfo):列表
No. |
字段 |
字段名 |
类型 |
必传 |
备注 |
1 |
merchantInfo |
商户会员信息 |
Json String |
N |
渠道会员信息,核保时候必传 |
2 |
underwriteInfo |
核保信息 |
Json String |
Y |
投被保人的相关个人信息,包括姓名,电子邮箱,证件,关系等信息 |
3 |
paymentInfo |
支付信息 |
Json String |
N |
订单支付的信息 |
4 |
insureInfo |
出单信息 |
Json String |
N |
出单时必传 |
分销商户信息(merchantInfo):
No. |
字段 |
字段名 |
类型 |
必传 |
备注 |
1 |
merchantMemberNo |
分销商户会员号 |
String |
Y |
苏宁内部渠道传易付宝户头号 |
2 |
memberName |
会员姓名 |
String |
N |
|
3 |
memberCardType |
会员证件类型 |
int |
N |
详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义") |
4 |
memberCardNo |
会员证件号 |
String |
N |
|
5 |
memberSex |
会员性别 |
String |
N |
详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义") |
6 |
memberBirthday |
会员出生日期 |
String |
N |
格式为YYYY-MM-DD |
7 |
memberMobile |
会员手机号码 |
String |
Y |
|
8 |
memberEmail |
会员邮箱 |
String |
N |
|
9 |
memberAddress |
会员详细地址 |
String |
N |
|
10 |
memberOccupationName |
会员职业名称 |
String |
N |
|
11 |
merchantNo |
商户号 |
String |
Y |
合作时提供 |
核保信息(underwriteInfo):
No. |
字段 |
字段名 |
类型 |
必传 |
备注 |
1 |
productCode |
保险产品编码 |
字符 |
Y |
合作时提供 |
2 |
unitAmount |
单价 |
数值 |
Y |
投保时需要支付的金额。以分为单位。 |
3 |
applyNum |
保险份数 |
数值 |
Y |
默认为1 |
4 |
totalAmount |
总保费 |
数值 |
Y |
趸交险种是单价×投保份数;期缴险种,是保单的总保费。以分为单位 |
5 |
insAmount |
总保额 |
数值 |
Y |
每个保险产品的总保障金额 |
6 |
skuCode |
保险公司sku编码 |
字符 |
Y |
保险公司定义的险种代码,合作时提供 |
7 |
insBeginDate |
保险起期 |
时间 |
Y |
yyyy-MM-dd HH:mm:ss 保险生效起始时间,常规险种为投保成功后次日0时。可根据保司产品规则额外设置,或者让用户自定义生效日期 |
8 |
insEndDate |
保险止期 |
时间 |
N |
yyyy-MM-dd HH:mm:ss 保险生效截止时间,根据产品保障期间,系统计算出截止日期 |
9 |
insPeriod |
保险期限 |
字符 |
N |
保障期间,如果保险公司发布险种时指定了保障期间,系统填入值。格式为xxD,最后一位为单位,格式为:D-天Y-年W-周M-月,否则为空 |
10 |
holderInfo |
投保人信息 |
Json String |
Y |
投保人的相关个人信息,包括投保人姓名,电子邮箱,证件等信息 |
11 |
insuredInfo |
被保人信息 |
Json String |
Y |
被保人的相关个人信息,包括被保人姓名,电子邮箱,证件,和投保人关系等信息 |
12 |
benifitInfo |
受益人信息 |
Json String |
N |
受益人的相关个人信息,包括受益人姓名,电子邮箱,证件等信息 |
13 |
otherInfo |
其他特殊字段 |
Json String |
N |
一些其他特殊字段 |
投保人信息(holderInfo):
No. |
字段 |
字段名 |
类型 |
必传 |
备注 |
1 |
holderName |
投保人姓名 |
字符 |
Y |
|
2 |
holderEmail |
投保人电子邮件 |
字符 |
N |
|
3 |
holderCardType |
投保人证件类型 |
字符 |
Y |
详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义") |
4 |
holderCardNo |
投保人证件号 |
字符 |
Y |
|
5 |
holderBirthday |
投保人出生日期 |
字符 |
Y |
|
6 |
holderSex |
投保人性别 |
数值 |
N |
1:男 2:女 |
7 |
holderMobile |
投保人手机号 |
字符 |
Y |
|
8 |
province |
常住地区-省 |
字符 |
N |
|
9 |
city |
常住地区-市 |
字符 |
N |
|
10 |
holderAddress |
投保人地址 |
字符 |
N |
|
11 |
holderZipCode |
投保人邮编 |
字符 |
N |
|
被保人信息(insuredInfo):
No. |
字段 |
字段名 |
类型 |
必传 |
备注 |
1 |
channelOrderNo |
渠道订单号 |
字符 |
Y |
|
1 |
insuredName |
被保人姓名 |
字符 |
N |
|
2 |
insuredEmail |
被保人电子邮件 |
字符 |
N |
|
3 |
insuredCardType |
被保人证件类型 |
字符 |
N |
详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义") |
4 |
insuredCardNo |
被保人证件号 |
字符 |
N |
|
5 |
insuredBirthday |
被保人出生日期 |
字符 |
N |
|
6 |
insuredSex |
被保人性别 |
数值 |
N |
1:男 2:女 |
7 |
insuredMobile |
被保人手机号 |
字符 |
N |
|
8 |
province |
常住地区-省 |
字符 |
N |
|
9 |
city |
常住地区-市 |
字符 |
N |
|
10 |
insuredAddress |
被保人地址 |
字符 |
N |
|
11 |
insuredZipCode |
被保人邮编 |
字符 |
N |
|
12 |
insuredRelation |
与投保人关系 |
数值 |
Y |
详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义") |
受益人信息(benifitInfo):如果受益人与被保人关系是法定,则下面受益人信息不填
No. |
字段 |
字段名 |
类型 |
必传 |
备注 |
1 |
benefitName |
受益人姓名 |
字符 |
N |
|
2 |
benefitEmail |
受益人电子邮件 |
字符 |
N |
|
3 |
benefitCardType |
受益人证件类型 |
字符 |
N |
详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义") |
4 |
benefitCardNo |
受益人证件号 |
字符 |
N |
|
5 |
benefitBirthday |
受益人出生日期 |
字符 |
N |
|
6 |
benefitSex |
受益人性别 |
数值 |
N |
1:男 2:女 |
7 |
benefitMobile |
受益人手机号 |
字符 |
N |
|
8 |
province |
常住地区-省 |
字符 |
N |
|
9 |
city |
常住地区-市 |
字符 |
N |
|
10 |
benefitAddress |
受益人地址 |
字符 |
N |
|
11 |
benefitZipCode |
受益人邮编 |
字符 |
N |
|
12 |
benefitRelation |
与被保人关系 |
字符 |
Y |
详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义") |
13 |
benefitScale |
受益比例 |
|
N |
|
其他信息(otherInfo):
No. |
字段 |
字段名 |
类型 |
必传 |
备注 |
1 |
extends1 |
隧道字段1 |
字符 |
N |
详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义") |
2 |
extends2 |
隧道字段2 |
字符 |
N |
|
3 |
extends3 |
隧道字段3 |
字符 |
N |
|
4 |
extends4 |
隧道字段4 |
字符 |
N |
|
5 |
extends5 |
隧道字段5 |
字符 |
N |
|
6 |
extends6 |
隧道字段6 |
字符 |
N |
|
7 |
extends7 |
隧道字段7 |
字符 |
N |
|
8 |
extends8 |
隧道字段8 |
字符 |
N |
|
9 |
extends9 |
隧道字段9 |
字符 |
N |
|
支付信息(paymentInfo):
No. |
字段 |
名称 |
类型 |
必传 |
备注 |
1 |
orderId |
苏宁保险订单号 |
字符 |
N |
|
2 |
channelOrderNo |
渠道订单号 |
字符 |
Y |
|
3 |
paySource |
支付方式 |
字符 |
Y |
1、易付宝支付2、支付宝支付 |
4 |
payId |
支付单号 |
字符 |
Y |
|
5 |
payTime |
支付时间 |
时间 |
Y |
yyyy-MM-dd HH:mm:ss(如若为赠险,则放空) |
6 |
payAmount |
支付金额 |
数值 |
Y |
以分为单位(如若为赠险,则放空) |
出单信息(insureInfo):
No. |
字段 |
名称 |
类型 |
必传 |
备注 |
1 |
orderId |
苏宁保险订单号 |
字符 |
Y |
|
请求报文示例
{
"requestInfo": {
"underWrite": "1",
"payment": "1",
"insure": "1",
"syn": "1"
},
" insuranceInfo ": [
{
"merchantInfo": {
"merchantMemberNo": "",
"memberName": "",
"memberCardType": "",
"memberCardNo": "",
"memberSex": "",
"memberBirthday": "",
"memberMobile": "",
"memberEmail": "",
"memberAddress": "",
"memberOccupationName": "",
"merchantNo": ""
},
"underwriteInfo": {
"productCode": "",
"applyNum": "",
"unitAmount": "",
"insBeginDate": "2016-02-03 19: 06: 00",
"insEndDate": "2016-02-04 20: 45: 00",
"holderInfo": {
"holderAddress": "",
"holderBirthday": "1991-03-14",
"holderCardNo": "321324199103140617",
"holderCardType": "1",
"holderEmail": "zhangsan@suning.com",
"holderMobile": "18633665599",
"holderName": "张三",
"holderSex": "1",
"holderZipCode": "100000",
"city": "北京",
"province": "北京"
},
"insuredInfo": {
"channelOrderNo": "12312312",
"insuredRelation": "0",
"insuredCardNo": "12312312312312",
"insuredCardType": "1",
"insuredEmail": "12@asd.com",
"insuredName": "李四",
"benifitInfo": [
{
"benefitRelation": "0",
"benefitCardNo": "231231231231",
"benefitCardType": "1",
"benefitEmail": "12312312@qq.com",
"benefitName": "王二",
"benefitScale": "1"
},
{
"benefitCardNo": "231231231231",
"benefitCardType": "1",
"benefitEmail": "12312312@qq.com",
"benefitName": "王二打算",
"benefitRelation": "0",
"benefitScale": "1"
}
]
},
"otherInfo": {
"extends1": [
{
"code": "flightNumber",
"value": "SJ2018",
"desc": "航班号"
},
{
"code": "trainTicket",
"value": "SJ2018",
"desc": "火车票号"
},
{
"code": " endorseTime ",
"value": "2018-03-26 12:12:12",
"desc": "修改时间"
},
{
"code": " FlyTime ",
"value": "2018-03-26 12:12:12",
"desc": "起飞时间"
}
],
"extends2": "",
"extends3": "",
"extends4": ""
}
},
"paymentInfo": {
"orderId": "",
"channelOrderNo": "",
"payId": "",
"payTime": "2018-12-12 23:59:59",
"payAmount": "1000"
},
"insureInfo": {
"orderId": "2018121212312312"
}
},
{
"merchantInfo": {
"merchantMemberNo": "",
"memberName": "",
"memberCardType": "",
"memberCardNo": "",
"memberSex": "",
"memberBirthday": "",
"memberMobile": "",
"memberEmail": "",
"memberAddress": "",
"memberOccupationName": "",
"merchantNo": ""
},
"underwriteInfo": {
"productCode": "",
"applyNum": "",
"unitAmount": "",
"insBeginDate": "2016-02-03 19: 06: 00",
"insEndDate": "2016-02-04 20: 45: 00",
"holderInfo": {
"holderAddress": "",
"holderBirthday": "1991-03-14",
"holderCardNo": "321324199103140617",
"holderCardType": "1",
"holderEmail": "zhangsan@suning.com",
"holderMobile": "18633665599",
"holderName": "张三",
"holderSex": "1",
"holderZipCode": "100000",
"city": "北京",
"province": "北京"
},
"insuredInfo": {
"channelOrderNo": "12312312",
"insuredRelation": "0",
"insuredCardNo": "12312312312312",
"insuredCardType": "1",
"insuredEmail": "12@asd.com",
"insuredName": "李四",
"benifitInfo": [
{
"benefitRelation": "0",
"benefitCardNo": "231231231231",
"benefitCardType": "1",
"benefitEmail": "12312312@qq.com",
"benefitName": "王二",
"benefitScale": "1"
},
{
"benefitCardNo": "231231231231",
"benefitCardType": "1",
"benefitEmail": "12312312@qq.com",
"benefitName": "王二打算",
"benefitRelation": "0",
"benefitScale": "1"
}
]
},
"otherInfo": {
"extends1": "",
"extends2": "",
"extends3": "",
"extends4": ""
}
},
"paymentInfo": {
"orderId": "",
"channelOrderNo": "",
"payId": "",
"payTime": "2018-12-12 23:59:59",
"payAmount": "1000"
},
"insureInfo": {
"orderId": "2018121212312312"
}
}
]
}
返回数据
返回信息:
No. |
字段 |
字段名 |
类型 |
必传 |
备注 |
1 |
code |
返回码 |
字符 |
Y |
500失败;200成功;501异常 |
2 |
content |
返回描述 |
字符 |
N |
成功或失败信息 |
3 |
syn |
是否同步 |
字符 |
N |
0:异步;1:同步 。异步则只有返回信息 |
4 |
underWrite |
核保 |
字符 |
N |
0:不传;1:核保;2:只保存信息不请求保险公司核保。为空默认为0 |
5 |
payment |
支付 |
字符 |
N |
0:不传 1:渠道支付 2:保险支付 为空默认为0 |
6 |
insure |
出单 |
字符 |
N |
0:不传;1:出单;2:一键出单;为空默认为0 |
7 |
status |
当前保险订单状态 |
字符 |
N |
详见[订单状态](https://www.showdoc.com.cn/snisc/8891382794486718 "订单状态") 同步返回才有此字段 |
核保信息(underwriteResInfo):
No. |
字段 |
字段名 |
类型 |
必传 |
备注 |
1 |
orderId |
订单号 |
字符 |
Y |
苏宁保险订单号 |
2 |
channelOrderNo |
渠道订单号 |
字符 |
Y |
渠道订单号 |
3 |
proposalNo |
投保单号 |
字符 |
Y |
|
4 |
underWriteTime |
核保时间 |
字符 |
Y |
|
支付信息(paymentInfo):(支付方式为苏宁保险支付时返回)
No. |
字段 |
名称 |
类型 |
必传 |
备注 |
1 |
orderCode |
苏宁保险订单号 |
字符 |
Y |
|
2 |
payUrl |
支付请求url |
字符 |
Y |
使用星灿保代的支付收银台时同步返回 |
出单信息(insureResInfo)
No. |
字段 |
名称 |
类型 |
必传 |
备注 |
1 |
orderId |
苏宁保险订单号 |
字符 |
Y |
|
2 |
channelOrderNo |
渠道订单号 |
字符 |
Y |
渠道订单号 |
3 |
proposalNo |
投保单号 |
字符 |
N |
出单成功必传 |
4 |
policyNo |
保单号 |
字符 |
Y |
保险公司生成保险合同单号 |
5 |
totalPremium |
总保费 |
数值 |
Y |
以分为单位 |
6 |
policyUrl |
电子保单URL |
字符 |
N |
|
7 |
accountDate |
账务日期 |
时间 |
N |
yyyy-MM-dd |
8 |
issuedTime |
出单时间 |
时间 |
Y |
保险公司出单时间 yyyy-MM-dd HH:mm:ss |
9 |
insuBeginDate |
保单开始日期 |
时间 |
Y |
保险起期 yyyy-MM-dd HH:mm:ss |
10 |
financialMaturity |
保单到期日 |
时间 |
Y |
保单到期日期 yyyy-MM-dd HH:mm:ss |
返回报文示例
同步请求返回示例:
[
{
"code": "200",
"content": "",
"status": "3",
"underwriteResInfo": {
"orderId": "312312312",
"channelOrderNo": "21312312",
"proposalNo": "21312312",
"underWriteTime": "2018-03-23 12:12:12"
},
"insureResInfo": {
"orderId": "312312312",
"channelOrderNo": "21312312",
"proposalNo": "21312312",
"policyNo": "21312312",
"totalPremium": "1000",
"policyUrl": "http://issm.suning.com",
"accountDate": "2018-03-23",
"issuedTime": "2018-03-2312: 12: 12",
"insuBeginDate": "2018-03-2312: 12: 12",
"financialMaturity": "2018-03-2312: 12: 12"
}
}
]
异步请求返回示例:(异步只返回接收到数据)
{
"code": "",
"content": ""
}