人脸识别获取验证地址
<p><strong>简要描述：</strong> </p>
<ul>
<li>人脸识别获取验证地址</li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>API地址： <a href="https://open-beta.56yzm.com:8443">https://open-beta.56yzm.com:8443</a> （不同的环境，不同的API地址）</li>
<li>请求地址：/open-api/ocr/ocrFaceAuthUrl</li>
</ul>
<p><strong>请求头数据 </strong></p>
<ul>
<li>Content-Type : application/json;charset=UTF-8 </li>
<li>Authorization: Bearer {your_access_token} </li>
</ul>
<p><strong>入参参数：</strong> </p>
<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;">authType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>指定默认认证类型（打开认证页面所展示的第一个认证类型）PSN_BANK4_AUTHCODE - 个人银行卡四要素认证<br><br>PSN_TELECOM_AUTHCODE - 个人运营商三要素认证<br><br>PSN_FACEAUTH_BYURL - 个人刷脸认证</td>
</tr>
<tr>
<td style="text-align: left;">availableAuthTypes</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>指定页面显示认证方式<br><br>PSN_BANK4_AUTHCODE - 个人银行卡四要素认证<br><br>PSN_TELECOM_AUTHCODE - 个人运营商三要素认证<br><br>PSN_FACEAUTH_BYURL - 个人刷脸认证</td>
</tr>
<tr>
<td style="text-align: left;">authAdvancedEnabled</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>指定通过银行卡认证或运营商认证方式时，是否使用详情版，如指定则核验失败可返回具体不匹配信息，传空默认为普通版。<br><br>PSN_BANK4_AUTHCODE - 个人银行卡四要素认证<br><br>PSN_TELECOM_AUTHCODE - 个人运营商三要素认证<br><br>【注】详情版：需要单独购买，具体购买方式请咨询e签宝工作人员；<br><br>普通版：信息比对核验失败，不会返回具体的不匹配信息。</td>
</tr>
<tr>
<td style="text-align: left;">receiveUrlMobileNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接收实名认证链接短信通知的手机号。传入手机号会发送邀请实名认证短信通知到该用户，并收取一次短信费用，不传入则不发送，不产生短信费用</td>
</tr>
<tr>
<td style="text-align: left;">indivInfo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td>个人实名认证的基本信息</td>
</tr>
<tr>
<td style="text-align: left;">configParams</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td>个人实名认证的基本信息</td>
</tr>
<tr>
<td style="text-align: left;">contextInfo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td>业务方交互上下文信息，有统计需求或者分账需求必填部分参数</td>
</tr>
</tbody>
</table>
<p><strong>indivInfo 对象入参参数：</strong> </p>
<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;">bankCardNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>个人银行卡号（仅支持银联卡）</td>
</tr>
<tr>
<td style="text-align: left;">certNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>个人证件号</td>
</tr>
<tr>
<td style="text-align: left;">certType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>个人证件类型<br><br>INDIVIDUAL_CH_IDCARD -中国大陆身份证<br>INDIVIDUAL_CH_TWCARD -台湾来往大陆通行证（台胞证）<br>INDIVIDUAL_CH_HONGKONG_MACAO -港澳来往大陆通行证（回乡证）<br>INDIVIDUAL_PASSPORT -护照</td>
</tr>
<tr>
<td style="text-align: left;">mobileNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>个人手机号</td>
</tr>
</tbody>
</table>
<p><strong>configParams 对象入参参数：</strong> </p>
<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;">indivUneditableInfo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>设置个人认证页面上不可修改的基本信息。传空表示可以修改<br><br>name - 姓名<br><br>certNo - 证件号<br><br>mobileNo - 手机号<br><br>bankCardNo - 银行卡号</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>
</tr>
<tr>
<td style="text-align: left;">certNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>证件号</td>
</tr>
<tr>
<td style="text-align: left;">mobileNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>手机号</td>
</tr>
<tr>
<td style="text-align: left;">bankCardNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>银行卡号</td>
</tr>
</tbody>
</table>
<p><strong>contextInfo 对象入参参数：</strong> </p>
<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;">contextId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>自定义业务标识在异步通知时发送回发起方，直接对接客户建议上传相关订单Id或会员Id，渠道分销商建议上传客户唯一Id</td>
</tr>
<tr>
<td style="text-align: left;">notifyUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>发起方接收实名认证状态变更通知的地址</td>
</tr>
<tr>
<td style="text-align: left;">origin</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>认证发起来源，默认值为 BROWSER<br/><br/>BROWSER - 浏览器<br>APP - 移动端APP</td>
</tr>
<tr>
<td style="text-align: left;">redirectUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>认证结束后页面跳转地址</td>
</tr>
<tr>
<td style="text-align: left;">showResultPage</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>认证完成是否显示结果页，默认值为 true</td>
</tr>
<tr>
<td style="text-align: left;">true - 显示结果，false - 不显示结果</td>
</tr>
</tbody>
</table>
<p><strong>入参示例</strong></p>
<pre><code> {
&quot;authType&quot;: &quot;PSN_FACEAUTH_BYURL&quot;,
&quot;availableAuthTypes&quot;: [
&quot;PSN_FACEAUTH_BYURL&quot;
],
&quot;configParams&quot;: {
&quot;indivUneditableInfo&quot;: [
&quot;name&quot;,
&quot;certNo&quot;
]
},
&quot;contextInfo&quot;: {
&quot;contextId&quot;: &quot;211cd6e968bf8825f87845ca2b3633bf&quot;,
&quot;notifyUrl&quot;: &quot;https://yzm-api-prod.56yzm.com/mobile/account/ocrFaceChangePhone?newPhone=13933351573&amp;userId=211cd6e968bf8825f87845ca2b3633bf&amp;appId=44549625&quot;,
&quot;origin&quot;: &quot;APP&quot;,
&quot;redirectUrl&quot;: &quot;https://qhy.56yzm.com/&quot;,
&quot;showResultPage&quot;: true
},
&quot;indivInfo&quot;: {
&quot;certNo&quot;: &quot;13022919850824103X&quot;,
&quot;certType&quot;: &quot;INDIVIDUAL_CH_IDCARD&quot;,
&quot;mobileNo&quot;: &quot;13933351511&quot;,
&quot;name&quot;: &quot;李道平&quot;
}
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<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;">flowId</td>
<td style="text-align: left;">string</td>
<td>认证流程ID</td>
</tr>
<tr>
<td style="text-align: left;">shortLink</td>
<td style="text-align: left;">object</td>
<td>个人实名认证短链接（链接有效期30天）</td>
</tr>
<tr>
<td style="text-align: left;">url</td>
<td style="text-align: left;">string</td>
<td>个人实名认证长链接（链接永久有效）</td>
</tr>
</tbody>
</table>
<p><strong>出参示例</strong></p>
<pre><code>{
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;string&quot;,
&quot;data&quot;: {
&quot;flowId&quot;: &quot;string&quot;,
&quot;shortLink&quot;: &quot;string&quot;,
&quot;url&quot;: &quot;string&quot;
}
}</code></pre>