绑卡请求
<h5>简要描述</h5>
<ul>
<li>该接口提供绑卡请求,该接口请求成功后需调求短验确认接口完成整个绑卡动作</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/vborder/bindCard/create</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<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;">orderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>商户绑卡请求号,商户系统内部生成的订单号，需要保持在同一个商户下唯一 <br> <span style="color:#F00"> 示例：2022090700001</td>
</tr>
<tr>
<td style="text-align: left;">userType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(10)</td>
<td>可选项如下:<br>IMEI:imei<br>MAC:网卡地址<br>USER_ID:用户 ID<br>EMAIL:用户注册email<br>PHONE:用户注册手机号<br>ID_CARD:用户身份证号<br>AGREEMENT_NO:用户纸质订单协议号<br>WECHAT:微信号</td>
</tr>
<tr>
<td style="text-align: left;">identifyId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>用户标识,保证每个支付用户唯一，绑卡的标识性数据。形成绑卡关系后，卡会绑定在这个用户标识下。 <br> <span style="color:#F00"> 示例：如用户类型选择EMAIL,标识则为xxxx@email.com</span></td>
</tr>
<tr>
<td style="text-align: left;">accType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(8)</td>
<td>银行卡账户类型,可选项如下:<br>PRIVATE:对私<br>PUBLIC:对公 <br> <span style="color:#F00"> 示例：PRIVATE</td>
</tr>
<tr>
<td style="text-align: left;">bankCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(16)</td>
<td>银行编码 微保提供 <br> <span style="color:#F00"> 示例：ICBC</td>
</tr>
<tr>
<td style="text-align: left;">bankCardType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(10)</td>
<td>银行卡类型,可选项如下:<br>CREDIT:贷记卡<br>DEBIT:借记卡 <br> <span style="color:#F00"> 示例：CREDIT</td>
</tr>
<tr>
<td style="text-align: left;">bankCardNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>银行卡号 <br> <span style="color:#F00"> 示例：621912345678910</td>
</tr>
<tr>
<td style="text-align: left;">bankCardName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>持卡人姓名 <br> <span style="color:#F00"> 示例：张三</td>
</tr>
<tr>
<td style="text-align: left;">certType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(20)</td>
<td>证件类型，可选项如下：<br>ID:身份证<br>OFFICERS:军官证<br>PASSPORT:护照<br>REENTRY:回乡证<br>TAIWAN:台胞证<br>POLICE:警官证<br>SOLDIER:士兵证<br>HM_VISITORPASS:港澳居民往来内地通行证<br>RESIDENCEBOOKLET:户口薄<br>TEMPIDCARD:临时身份证<br>FR_CARD:外国人居留证</td>
</tr>
<tr>
<td style="text-align: left;">certNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>需上送与证件类型对应的证件号码，需与开卡信息一致 <br> <span style="color:#F00"> 示例：110123199001011234</td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(11)</td>
<td>手机号 <br> <span style="color:#F00"> 示例：18812345678</td>
</tr>
<tr>
<td style="text-align: left;">creditCvv2</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(3)</td>
<td>cvv2,信用卡背面3位数字，信用卡必填 <br> <span style="color:#F00"> 示例：123</td>
</tr>
<tr>
<td style="text-align: left;">creditValid</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(4)</td>
<td>信用卡有效期， 格式： MMYY(月月年年)，（2贷记卡/信用卡）必填 <br> <span style="color:#F00"> 示例：0722</td>
</tr>
<tr>
<td style="text-align: left;">expiredTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(19)</td>
<td>格式：yyyy-MM-dd HH:mm:ss； <br> <span style="color:#F00"> 示例：2023-01-01 12:05:01</td>
</tr>
<tr>
<td style="text-align: left;">authType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(20)</td>
<td>鉴权类型,可选项如下：<br>COMMON_FOUR：卡号、姓名、证件号、手机号 四要素验证<br>CREDIT_SIX：卡号、姓名、证件号、手机号、cvv2、信用卡有效期 六要素验证（2贷记卡/信用卡） <br> <span style="color:#F00"> 示例：CREDIT_SIX</td>
</tr>
<tr>
<td style="text-align: left;">isSMS</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(5)</td>
<td>是否短验，默认true；<br>true：发短验；false不发短验； <br> <span style="color:#F00"> 示例：true</td>
</tr>
</tbody>
</table>
<h5>返回参数说明</h5>
<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;">customerNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>商户号 <br><span style="color:#F00"> 示例：202112090603</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>商户绑卡请求号<br><span style="color:#F00"> 示例：2022090700001</td>
</tr>
<tr>
<td style="text-align: left;">errCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>错误编码 <br><span style="color:#F00"> 示例：0000</td>
</tr>
<tr>
<td style="text-align: left;">errMessage</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(256)</td>
<td>错误描述<br><span style="color:#F00"> 示例：成功</td>
</tr>
<tr>
<td style="text-align: left;">bindId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>无短验情况下，直接返回绑卡ID<br><span style="color:#F00"> 示例：xxxxxxxxxxxxxx</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(32)</td>
<td>签名 <br><span style="color:#F00"> 示例：ql99NNtkWrsVJcfUyKfeRlVVsorqkulKviTUY5vXZtxRH+quqcBhngd4tW0GxqLi80RbxDCh1EgHErF0In51ZUvWW8L1tlTSl+Y6+hFtFoNKdNqhopgujtQlI1kHSo4W0k7q8xx3pCq3PA7AjFhZlXW2RdSk3HQa8DXvjAbQmxUVz9J8urOAWKpFboW8Bs8HHlVE/G7UmcRj6YUkZyOhcVf46Ux6aP5tm2InyX9tJoFZXCn8qXqxOjWAaDkxfBeobC7kdCcUHOhCtLpjMHLuGdM0ZvJBSGDoU4j/AJYnVUgO/LbWZpVgR3Bkp53MI/iEJdjx/rvzNZ9lmfXpejJkcw==</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;:&quot;200&quot;,
&quot;success&quot;:true,
&quot;data&quot;:&quot;{\&quot;customerNo\&quot;:\&quot;202112090603\&quot;,\&quot;reqmsg\&quot;:\&quot;eueJn2YkFO9hyfsv9Rhth69iVi6NpKQ8YoZ63HN8Dl47ZxvXTXXnJd37VWLKjAN6ci2zfg9jjhtA2pC/Dk/nIUeALNT3qhNiWHid1bO28SiZgdEk2hzikDa6wtbgA9VaTB0tyv1/mcPFFy1I9jeqUZOiyK7dz82lwKgX+CxmRvMh/3EKbVtzoujE5EuMTx3sOXQnIatj9Ci4XVw8hskG1KemhlQ24MczSsKZf/uKrBkmQ9RT/Imh5zpbz98ifjK44uQv7zvJPtZzF9kf9KzBTuURTfwx12EYZChLw0GgW7iBwZB03lCHb5ohg0f6cLW1FX8kq5VZq0GSIMvX92eUtw==\&quot;}&quot;,
&quot;msg&quot;:&quot;操作成功&quot;
}
reqmsg明文：
{
&quot;orderNo&quot;: &quot;BCC287242753802400&quot;,
&quot;customerNo&quot;: &quot;202112090603&quot;,
&quot;errCode&quot;: &quot;7001&quot;,
&quot;errMessage&quot;: &quot;短信验证码已发送,请调用短验确认接口&quot;,
&quot;sign&quot;: &quot;148C83F70C54670F4A0F711569E580A4&quot;
}</code></pre>
<h5>错误码</h5>
<table>
<thead>
<tr>
<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;">0000</td>
<td style="text-align: left;">成功</td>
<td style="text-align: left;">绑卡成功，可获取绑卡id</td>
</tr>
<tr>
<td style="text-align: left;">9999</td>
<td style="text-align: left;">其他错误</td>
</tr>
<tr>
<td style="text-align: left;">1001</td>
<td style="text-align: left;">系统异常</td>
</tr>
<tr>
<td style="text-align: left;">1002</td>
<td style="text-align: left;">请求参数错误</td>
</tr>
<tr>
<td style="text-align: left;">1003</td>
<td style="text-align: left;">必填参数为空</td>
</tr>
<tr>
<td style="text-align: left;">2001</td>
<td style="text-align: left;">商户信息异常，请联系客服</td>
</tr>
<tr>
<td style="text-align: left;">2002</td>
<td style="text-align: left;">渠道处理失败</td>
<td style="text-align: left;">请换单重试</td>
</tr>
<tr>
<td style="text-align: left;">2104</td>
<td style="text-align: left;">订单已存在，请勿重复提交</td>
</tr>
<tr>
<td style="text-align: left;">2106</td>
<td style="text-align: left;">订单不存在</td>
</tr>
<tr>
<td style="text-align: left;">7000</td>
<td style="text-align: left;">请调用查单接口</td>
</tr>
<tr>
<td style="text-align: left;">7001</td>
<td style="text-align: left;">短信验证码已发送,请调用短验确认接口</td>
</tr>
<tr>
<td style="text-align: left;">7003</td>
<td style="text-align: left;">订单已成功或失败，请联系客服</td>
</tr>
<tr>
<td style="text-align: left;">7004</td>
<td style="text-align: left;">绑卡失败，请求入参错误/非法</td>
</tr>
<tr>
<td style="text-align: left;">7005</td>
<td style="text-align: left;">绑卡失败，请更换绑卡请求号重新发起请求</td>
</tr>
<tr>
<td style="text-align: left;">7006</td>
<td style="text-align: left;">短验发送失败/错误，请调用绑卡短验发送请求接口</td>
<td style="text-align: left;">需调用绑卡短验发送接口</td>
</tr>
<tr>
<td style="text-align: left;">7007</td>
<td style="text-align: left;">绑卡失败，订单超过有效期</td>
</tr>
<tr>
<td style="text-align: left;">7008</td>
<td style="text-align: left;">短验发送失败/错误，请调用绑卡支付请求短验接口</td>
</tr>
<tr>
<td style="text-align: left;">7009</td>
<td style="text-align: left;">查无此绑卡ID，请提供准确的绑卡ID</td>
</tr>
<tr>
<td style="text-align: left;">7100</td>
<td style="text-align: left;">解绑失败，已解绑</td>
<td style="text-align: left;">已解绑，同成功0000处理</td>
</tr>
<tr>
<td style="text-align: left;">7999</td>
<td style="text-align: left;">其他错误码值，具体见errMessage返回信息</td>
</tr>
</tbody>
</table>