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

苏宁保与外部的接口文档


出单成功结果回传给分销渠道

<p>[TOC]</p> <h1>接口概述</h1> <p>分销渠道的保单,在保司/平台投保成功后,星灿通过分销渠道提供的推送地址,将保单信息推送给分销渠道。</p> <h1>请求URL</h1> <p><code>TO分销渠道地址</code></p> <h1>请求方式</h1> <p>POST </p> <h1>请求参数</h1> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">NotifyType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>通知类型:固定传01</td> </tr> </tbody> </table> <h4>保单信息(OrderInfo)</h4> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">OrderId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>星灿保代订单号</td> </tr> <tr> <td style="text-align: left;">PolicyNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>保单号</td> </tr> <tr> <td style="text-align: left;">ProductCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>星灿保代产品编码</td> </tr> <tr> <td style="text-align: left;">ProductName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>星灿保代产品名称</td> </tr> <tr> <td style="text-align: left;">SkuCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>保险公司产品代码</td> </tr> <tr> <td style="text-align: left;">TotalPremium</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>总保费,指整张保单在缴费期间内,所需缴纳保费的金额总和,以分为单位</td> </tr> <tr> <td style="text-align: left;">PolicyUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>电子保单URL</td> </tr> <tr> <td style="text-align: left;">IssuedTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>出单时间</td> </tr> <tr> <td style="text-align: left;">InsuBeginDate</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>保单生效日期,yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">FinancialMaturity</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>保单终止日期yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">InsPeriodFlag</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>保障期限单位,详见[通用字段定义](<a href="https://www.showdoc.com.cn/snisc/8799604614404574">https://www.showdoc.com.cn/snisc/8799604614404574</a> &quot;通用字段定义&quot;)</td> </tr> <tr> <td style="text-align: left;">InsPeriod</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>保障期间值</td> </tr> <tr> <td style="text-align: left;">PayInterval</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>缴费频率,详见[通用字段定义](<a href="https://www.showdoc.com.cn/snisc/8799604614404574">https://www.showdoc.com.cn/snisc/8799604614404574</a> &quot;通用字段定义&quot;)</td> </tr> <tr> <td style="text-align: left;">PayPeriodFlag</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>缴费期限单位,详见[通用字段定义](<a href="https://www.showdoc.com.cn/snisc/8799604614404574">https://www.showdoc.com.cn/snisc/8799604614404574</a> &quot;通用字段定义&quot;)</td> </tr> <tr> <td style="text-align: left;">PayPeriod</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>缴费期限值</td> </tr> <tr> <td style="text-align: left;">PayTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>首次投保支付时间 ,yyyy-MM-dd HH:mm:ss(如若为赠险则放空)</td> </tr> <tr> <td style="text-align: left;">PayAmount</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>首次投保支付金额,以分为单位(如若为赠险,则放空)</td> </tr> <tr> <td style="text-align: left;">UtmSource</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>投放渠道标识 ,投保url中,如果有个性化的投保渠道标识,则保单回传时有</td> </tr> </tbody> </table> <h4>投保人信息(HolderInfo):数组</h4> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">HolderName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>投保人姓名</td> </tr> <tr> <td style="text-align: left;">HolderEmail</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>投保人电子邮件</td> </tr> <tr> <td style="text-align: left;">HolderCardType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>投保人证件类型,详见[通用字段定义](<a href="https://www.showdoc.com.cn/snisc/8799604614404574">https://www.showdoc.com.cn/snisc/8799604614404574</a> &quot;通用字段定义&quot;)</td> </tr> <tr> <td style="text-align: left;">HolderCardNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>投保人证件号</td> </tr> <tr> <td style="text-align: left;">HolderBirthday</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>投保人出生日期</td> </tr> <tr> <td style="text-align: left;">HolderSex</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>投保人性别:1:男 2:女</td> </tr> <tr> <td style="text-align: left;">HolderMobile</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>投保人手机号</td> </tr> <tr> <td style="text-align: left;">ResidentProvince</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>常住地区-省</td> </tr> <tr> <td style="text-align: left;">ResidentCity</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>常住地区-市</td> </tr> <tr> <td style="text-align: left;">HolderAddress</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>投保人地址</td> </tr> <tr> <td style="text-align: left;">HolderZip</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>投保人邮编</td> </tr> <tr> <td style="text-align: left;">ServiceArea</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>投保人服务区编码</td> </tr> </tbody> </table> <h4>被保人信息(InsuredInfo):数组</h4> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">InsuredName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>被保人姓名</td> </tr> <tr> <td style="text-align: left;">InsuredEmail</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>被保人电子邮箱</td> </tr> <tr> <td style="text-align: left;">InsuredCardType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>被保人证件类型,详见[通用字段定义](<a href="https://www.showdoc.com.cn/snisc/8799604614404574">https://www.showdoc.com.cn/snisc/8799604614404574</a> &quot;通用字段定义&quot;)</td> </tr> <tr> <td style="text-align: left;">InsuredCardNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>被保人证件号</td> </tr> <tr> <td style="text-align: left;">InsuredBirthday</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>被保人出生日期</td> </tr> <tr> <td style="text-align: left;">InsuredSex</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>被保人性别:1:男 2:女</td> </tr> <tr> <td style="text-align: left;">InsuredMobile</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>被保人手机号</td> </tr> <tr> <td style="text-align: left;">ResidentProvince</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>常住地区-省</td> </tr> <tr> <td style="text-align: left;">ResidentCity</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>常住地区-市</td> </tr> <tr> <td style="text-align: left;">InsuredAddress</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>被保人地址</td> </tr> <tr> <td style="text-align: left;">InsuredZip</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>被保人邮编</td> </tr> <tr> <td style="text-align: left;">InsuredRelation</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>与投保人关系,详见[通用字段定义](<a href="https://www.showdoc.com.cn/snisc/8799604614404574">https://www.showdoc.com.cn/snisc/8799604614404574</a> &quot;通用字段定义&quot;)</td> </tr> <tr> <td style="text-align: left;">MaininsuredRelation</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>与主被保人关系,详见[通用字段定义](<a href="https://www.showdoc.com.cn/snisc/8799604614404574">https://www.showdoc.com.cn/snisc/8799604614404574</a> &quot;通用字段定义&quot;)</td> </tr> </tbody> </table> <h4>受益人信息(BenefitInfo):数组</h4> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">BenefitName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>受益人姓名</td> </tr> <tr> <td style="text-align: left;">BenefitEmail</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>受益人电子邮件</td> </tr> <tr> <td style="text-align: left;">BenefitCardType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>受益人证件类型,详见[通用字段定义](<a href="https://www.showdoc.com.cn/snisc/8799604614404574">https://www.showdoc.com.cn/snisc/8799604614404574</a> &quot;通用字段定义&quot;)</td> </tr> <tr> <td style="text-align: left;">BenefitCardNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>受益人证件号</td> </tr> <tr> <td style="text-align: left;">BenefitBirthday</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>受益人出生日期</td> </tr> <tr> <td style="text-align: left;">BenefitSex</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>受益人性别:1:男 2:女</td> </tr> <tr> <td style="text-align: left;">BenefitMobile</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>受益人手机号</td> </tr> <tr> <td style="text-align: left;">ResidentProvince</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>常住地区-省</td> </tr> <tr> <td style="text-align: left;">ResidentCity</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>常住地区-市</td> </tr> <tr> <td style="text-align: left;">BenefitAddress</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>受益人地址</td> </tr> <tr> <td style="text-align: left;">BenefitZip</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>受益人邮编</td> </tr> <tr> <td style="text-align: left;">BenefitRelation</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>与被保人关系,详见[通用字段定义](<a href="https://www.showdoc.com.cn/snisc/8799604614404574">https://www.showdoc.com.cn/snisc/8799604614404574</a> &quot;通用字段定义&quot;)</td> </tr> <tr> <td style="text-align: left;">BenefitScale</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>受益比例,%</td> </tr> </tbody> </table> <h4>拓展信息(ExtendInfo)</h4> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">extends1</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>隧道字段1</td> </tr> <tr> <td style="text-align: left;">extends2</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>隧道字段2</td> </tr> <tr> <td style="text-align: left;">extends3</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>隧道字段3</td> </tr> <tr> <td style="text-align: left;">extends4</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>隧道字段4</td> </tr> <tr> <td style="text-align: left;">extends5</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>隧道字段5</td> </tr> </tbody> </table> <h1>请求示例</h1> <pre><code> { &amp;quot;NotifyType&amp;quot;:&amp;quot;01&amp;quot;, &amp;quot;OrderInfo&amp;quot;: { &amp;quot;OrderId&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;PolicyNo&amp;quot;: &amp;quot;12154545&amp;quot;, &amp;quot;ProductCode&amp;quot;: &amp;quot;P12345&amp;quot; }, &amp;quot;HolderInfo&amp;quot;:[ { &amp;quot;HolderName&amp;quot;: &amp;quot;李四&amp;quot;, &amp;quot;HolderEmail&amp;quot;: &amp;quot;12154545&amp;quot;, &amp;quot;HolderCardType&amp;quot;: &amp;quot;P12345&amp;quot;, ... },{ &amp;quot;HolderName&amp;quot;: &amp;quot;张三&amp;quot;, &amp;quot;HolderEmail&amp;quot;: &amp;quot;12154545&amp;quot;, &amp;quot;HolderCardType&amp;quot;: &amp;quot;P12345&amp;quot;, ... } ] &amp;quot;InsuredInfo&amp;quot;:[ { &amp;quot;InsuredName&amp;quot;: &amp;quot;李四&amp;quot;, &amp;quot;InsuredEmail&amp;quot;: &amp;quot;12154545&amp;quot;, &amp;quot;InsuredCardType&amp;quot;: &amp;quot;P12345&amp;quot; },{ &amp;quot;InsuredName&amp;quot;: &amp;quot;张三&amp;quot;, &amp;quot;InsuredEmail&amp;quot;: &amp;quot;12154545&amp;quot;, &amp;quot;InsuredCardType&amp;quot;: &amp;quot;P12345&amp;quot; }, ... ] &amp;quot;BenefitInfo&amp;quot;:[ { &amp;quot;BenefitName&amp;quot;: &amp;quot;李四&amp;quot;, &amp;quot;BenefitEmail&amp;quot;: &amp;quot;12154545&amp;quot;, &amp;quot;BenefitCardType&amp;quot;: &amp;quot;P12345&amp;quot; },{ &amp;quot;BenefitName&amp;quot;: &amp;quot;张三&amp;quot;, &amp;quot;BenefitEmail&amp;quot;: &amp;quot;12154545&amp;quot;, &amp;quot;BenefitCardType&amp;quot;: &amp;quot;P12345&amp;quot; }, ... ] &amp;quot;ExtendInfo&amp;quot;: { &amp;quot;OrderId&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;PolicyNo&amp;quot;: &amp;quot;12154545&amp;quot;, &amp;quot;ProductCode&amp;quot;: &amp;quot;P12345&amp;quot; }, }</code></pre> <h1>返回参数说明</h1> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">string</td> <td>500失败;200成功;</td> </tr> <tr> <td style="text-align: left;">message</td> <td style="text-align: left;">string</td> <td>失败原因</td> </tr> </tbody> </table> <h1>返回示例</h1> <pre><code> { &amp;quot;code&amp;quot;: &amp;quot;200&amp;quot;, &amp;quot;message&amp;quot;: &amp;quot;XXX&amp;quot; }</code></pre> <h1>备注</h1> <p>加密和签名demo请阅读[【公共说明】](<a href="https://www.showdoc.com.cn/snisc/9805767650650643">https://www.showdoc.com.cn/snisc/9805767650650643</a> &quot;【公共说明】&quot;)描述</p>

页面列表

ITEM_HTML