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

苏宁保与外部的接口文档


退保信息推送

<h2>接口概述</h2> <p>1.当用户在保险公司退保完成后,保险公司需通过提供的接口地址回传退保信息给星灿保代 2.若推送发生异常,请保险公司务必有重试机制</p> <h2>推送地址</h2> <p>测试环境 :<a href="https://iosapipre.cnsuning.com/synccancel?supplierCode">https://iosapipre.cnsuning.com/synccancel?supplierCode</a>= 生产环境 :<a href="https://iosapi.suning.com/synccancel?supplierCode">https://iosapi.suning.com/synccancel?supplierCode</a>=</p> <h2>安全机制</h2> <p>AES加密 1、请求报文先用AES加密后Base64转码, 秘钥值由星灿保代提供 2、响应报文先用Base64解码后用AES解密 3、加密后的字符串,用key-value结构传参。{requestParam:加密字符串}</p> <h2>请求数据</h2> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">描述</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">supplierCode</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">供应商编码</td> <td style="text-align: left;">合作方编码,由苏宁分配</td> </tr> <tr> <td style="text-align: left;">policyNo</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">保单号</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">cancelTime</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">退保时间</td> <td style="text-align: left;">yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">refundTotalAmount</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">退保保费总金额</td> <td style="text-align: left;">单位分</td> </tr> <tr> <td style="text-align: left;">cancelEntity</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">退款主体</td> <td style="text-align: left;">1-保司已退 2-需要苏宁退</td> </tr> <tr> <td style="text-align: left;">cancelType</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">退保类型</td> <td style="text-align: left;">1-生效前撤单 2-犹豫期退保 3-退保 4-理赔解约</td> </tr> <tr> <td style="text-align: left;">cancelReason</td> <td style="text-align: left;">String</td> <td style="text-align: left;">N</td> <td style="text-align: left;">退保原因</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">extendMap</td> <td style="text-align: left;">map</td> <td style="text-align: left;">N</td> <td style="text-align: left;">扩展待用字段</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">refundDetail</td> <td style="text-align: left;">Array</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">退款信息</td> <td style="text-align: left;">期缴保单退保时必传</td> </tr> <tr> <td style="text-align: left;">refundNo</td> <td style="text-align: left;">String</td> <td style="text-align: left;">N</td> <td style="text-align: left;">退款单号</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">times</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">退款对应期缴期次号</td> <td style="text-align: left;">第一期传1,第二期传2,……</td> </tr> <tr> <td style="text-align: left;">refundAmount</td> <td style="text-align: left;">Integer</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">退款金额</td> <td style="text-align: left;">单位分</td> </tr> <tr> <td style="text-align: left;">refundTime</td> <td style="text-align: left;">String</td> <td style="text-align: left;">N</td> <td style="text-align: left;">退款时间</td> <td style="text-align: left;">yyyy-MM-dd HH:mm:ss</td> </tr> </tbody> </table> <h2>请求报文示例</h2> <pre><code> { &amp;quot;policyNo&amp;quot;: &amp;quot;2020030756015&amp;quot;, &amp;quot;cancelTime&amp;quot;: &amp;quot;2022-03-07 10:00:01&amp;quot;, &amp;quot;refundTotalAmount&amp;quot;: 10000000, &amp;quot;cancelEntity&amp;quot;: 1, &amp;quot;cancelType&amp;quot;: 1, &amp;quot;cancelReason&amp;quot;: &amp;quot;没钱&amp;quot;, &amp;quot;extendMap&amp;quot;: {}, &amp;quot;supplierCode&amp;quot;: &amp;quot;S001&amp;quot;, &amp;quot;refundDetail&amp;quot;: [ { &amp;quot;refundNo&amp;quot;: &amp;quot;1000001&amp;quot;, &amp;quot;times&amp;quot;: 1, &amp;quot;refundAmount&amp;quot;: 5000000, &amp;quot;refundTime&amp;quot;: &amp;quot;2022-03-07 10:00:01&amp;quot; }, { &amp;quot;refundNo&amp;quot;: &amp;quot;1000002&amp;quot;, &amp;quot;times&amp;quot;: 2, &amp;quot;refundAmount&amp;quot;: 5000000, &amp;quot;refundTime&amp;quot;: &amp;quot;2022-03-07 10:00:01&amp;quot; } ] } </code></pre> <h2>返回数据</h2> <table> <thead> <tr> <th style="text-align: left;">字段</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">描述</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">responseResult</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">返回结果</td> <td style="text-align: left;">json加密字符串</td> </tr> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">String</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">解密后的处理成功标识</td> <td style="text-align: left;">1.接收到推送数据处理成功,返回code=200;2.接收到推送数据处理失败,返回code!=200</td> </tr> <tr> <td style="text-align: left;">message</td> <td style="text-align: left;">String</td> <td style="text-align: left;">N</td> <td style="text-align: left;">解密后的处理失败原因</td> <td style="text-align: left;"></td> </tr> </tbody> </table> <h2>返回报文示例</h2> <pre><code>{ &amp;quot;responseResult&amp;quot;: &amp;quot;C8A21B1142882A86BC466D7BBB2510DBE465F2CD877BB4215E16B59E0DBA6F74C01D0098183F860BAE3C931ABBDF33C2&amp;quot; } </code></pre>

页面列表

ITEM_HTML