退保信息推送
<h2>接口概述</h2>
<p>1.当用户在保险公司退保完成后，保险公司需通过提供的接口地址回传退保信息给星灿保代
2.若推送发生异常，请保险公司务必有重试机制</p>
<h2>推送地址</h2>
<p>测试环境 ：<a href="https://ftpgsprexg.cnsuning.com/ftpgs/trade/iosGatewayService/cancel">https://ftpgsprexg.cnsuning.com/ftpgs/trade/iosGatewayService/cancel</a>
生产环境 ：<a href="https://mfg.suning.com/ftpgs/trade/iosGatewayService/cancel">https://mfg.suning.com/ftpgs/trade/iosGatewayService/cancel</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> {
"policyNo": "2020030756015",
"cancelTime": "2022-03-07 10:00:01",
"refundTotalAmount": 10000000,
"cancelEntity": 1,
"cancelType": 1,
"cancelReason": "没钱",
"extendMap": {},
"supplierCode": "S001",
"refundDetail": [
{
"refundNo": "1000001",
"times": 1,
"refundAmount": 5000000,
"refundTime": "2022-03-07 10:00:01"
},
{
"refundNo": "1000002",
"times": 2,
"refundAmount": 5000000,
"refundTime": "2022-03-07 10:00:01"
}
]
}
</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>{
"responseResult": "C8A21B1142882A86BC466D7BBB2510DBE465F2CD877BB4215E16B59E0DBA6F74C01D0098183F860BAE3C931ABBDF33C2"
}
</code></pre>