星灿接收投保数据-充电桩保险
<p>[TOC]</p>
<h2>简要描述</h2>
<p>合作方调用该接口进行充电桩保险投保</p>
<h2>请求URL</h2>
<p>测试环境：
生产环境：</p>
<h2>请求方式</h2>
<ul>
<li>POST </li>
</ul>
<h2>安全机制</h2>
<p>AES加密
1、请求报文先用AES加密后Base64转码, 秘钥值由星灿保代提供
2、响应报文先用Base64解码后用AES解密
3、MD5生成sign
4、加密后的字符串，用key-value结构传参。{"MerchantNo":"S111","requestParam":"请求参数加密字符串"，"sign":"xxxxxx"}
详见[公共说明](<a href="https://www.showdoc.com.cn/snisc/9805767650650643">https://www.showdoc.com.cn/snisc/9805767650650643</a> "公共说明")</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>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">MerchantNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接入商户号，由星灿分配</td>
</tr>
<tr>
<td style="text-align: left;">MerchantOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户侧唯一订单号；如果同一个订单号重复请求，则会幂等返回上一次的结果</td>
</tr>
<tr>
<td style="text-align: left;">UserId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>充电用户id</td>
</tr>
<tr>
<td style="text-align: left;">ChargingStationCode</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;">ChargingStationAddress</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>充电桩详细地址</td>
</tr>
<tr>
<td style="text-align: left;">PlanNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>方案号；PL04B801：按次方案；PL04B802：按月方案；PL04B803：按年方案</td>
</tr>
<tr>
<td style="text-align: left;">BeginDate</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;">EndDate</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;">HolderName</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> "通用字段定义")</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;">InsuredName</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> "通用字段定义")</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>
</tbody>
</table>
<h2>请求参数示例</h2>
<pre><code> {
&quot;MerchantNo&quot;: &quot;50000000&quot;,
&quot;MerchantOrderNo&quot;: &quot;2023051648444549&quot;,
&quot;UserId&quot;: &quot;FW1201&quot;,
&quot;ChargingStationCode&quot;: &quot;500&quot;,
&quot;ChargingStationAddress&quot;: &quot;100&quot;,
&quot;BeginDate&quot;: &quot;RY00311889&quot;,
&quot;EndDate&quot;: &quot;167651557577&quot; ,
&quot;HolderName&quot;: &quot;王小二&quot; ,
&quot;HolderCardNo&quot;: &quot;210302199010101010&quot; ,
&quot;HolderCardType&quot;: &quot;1&quot; ,
&quot;InsuredName&quot;: &quot;王小二&quot; ,
&quot;InsuredCardType&quot;: &quot;210302199010101010&quot; ,
&quot;InsuredCardNo&quot;: &quot;1&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>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Code</td>
<td style="text-align: left;">是</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;">否</td>
<td style="text-align: left;">string</td>
<td>失败原因</td>
</tr>
<tr>
<td style="text-align: left;">MerchantOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户侧唯一订单号</td>
</tr>
<tr>
<td style="text-align: left;">OrderCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>星灿侧唯一订单号</td>
</tr>
</tbody>
</table>
<h2>返回示例</h2>
<pre><code> {
&quot;Code&quot;: &quot;200&quot;,
&quot;message&quot;: &quot;&quot;,
&quot;MerchantOrderNo&quot;: &quot;111111&quot;,
&quot;InsBeginDate&quot;: &quot;wx80ed3c0c3fc7aafb&quot;,
&quot;InsEndDate&quot;: &quot;pages/product/bx/myInst/myInst&quot;,
&quot;PolicyNo&quot;: &quot;pages/product/bx/myInst/myInst&quot;
}
</code></pre>
<h2>备注</h2>
<ul>
<li>安全机制及加密demo见[公共说明](<a href="https://www.showdoc.com.cn/snisc/9805767650650643">https://www.showdoc.com.cn/snisc/9805767650650643</a> "公共说明")</li>
</ul>