E签宝实名认证
<h4>说明</h4>
<p>用户发起实名认证时, 将用户填写的实名认证信息传给此接口, 后续的实名认证流程将由通知短信中包含认证链接的形式发给用户.
故此接口无返回信息.</p>
<h4>接口名称(Endpoint)</h4>
<p><code>/bos/scooter/goapi/order/realname-auth</code></p>
<h4>公共参数</h4>
<ul>
<li>openid</li>
</ul>
<h4>请求参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名<div style="width: 100pt"></th>
<th style="text-align: left;">必填</th>
<th style="text-align: left;">类型</th>
<th>字段描述<div style="width: 200pt"></th>
<th>备注<div style="width: 180pt"></th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>订单id</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户真实姓名</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户手机号码</td>
<td>将用作接收通知短信</td>
</tr>
<tr>
<td style="text-align: left;">cardType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户证件类型</td>
<td>由证件类型接口返回数据中选择</td>
</tr>
<tr>
<td style="text-align: left;">cardNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户证件号码</td>
<td></td>
</tr>
</tbody>
</table>
<h4>请求参数示例</h4>
<pre><code>{
&quot;id&quot;: &quot;1853892345734190&quot;, // 订单id
&quot;name&quot;:&quot;史瑾春&quot;, // 用户真实姓名
&quot;phone&quot;: &quot;14750734226&quot;, // 用户手机号码
&quot;cardType&quot;: &quot;CRED_PSN_CH_IDCARD&quot;, // 由证件类型接口返回数据中选择
&quot;cardNo&quot;: &quot;210204********&quot;, // 用户证件号码
}</code></pre>
<h4>成功-响应说明</h4>
<p>通用操作成功响应体</p>
<h4>失败-响应说明</h4>
<p>此接口出现失败, 一般是前端页面与后端实际订单状态不一致, 可直接刷新页面, 或尝试使用<code>获取用户当前订单接口</code>重新获取.
若用户重复点击, 可能为未收到通知短信. 此时将给出E签宝响应状态, 并返回备用链接.</p>
<table>
<thead>
<tr>
<th style="text-align: left;">code</th>
<th>message</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">1</td>
<td>订单状态不符, 无法进行实名认证</td>
</tr>
<tr>
<td style="text-align: left;">2</td>
<td>用户已经填报实名认证, 请勿重复填报. 若未收到通知短信, 请点击以下链接进入验证流程. (此状态下, data将携带备用链接)</td>
</tr>
<tr>
<td style="text-align: left;">3</td>
<td>E签宝获取认证信息异常, 原因: {} (将返回E签宝错误信息)</td>
</tr>
<tr>
<td style="text-align: left;">20</td>
<td>用户openid与所操作的订单不匹配</td>
</tr>
<tr>
<td style="text-align: left;">30</td>
<td>订单id无效</td>
</tr>
</tbody>
</table>