星灿保代保险平台接口文档

苏宁保与外部的接口文档


核保、支付、出单请求

接口概述

适用于分销渠道通过自有资源,销售星灿保代代理的保险产品。通过该接口实现线上核保、出单。 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": ""
} 

页面列表

ITEM_HTML