一键绑卡请求
<h5>简要描述</h5>
<ul>
<li>该接口提供一键绑卡请求,可通过此接口获取到拉起H5绑卡的银行端页面。</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/vborder/shortcut/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;">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;">bankCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(20)</td>
<td>银行卡编码</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;">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;">bindNotifyUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(256)</td>
<td>绑卡成功通知地址 <br> <span style="color:#F00"> 示例：<a href="http://xxxx/xxxx">http://xxxx/xxxx</a></td>
</tr>
<tr>
<td style="text-align: left;">pageReturnUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(256)</td>
<td>绑卡成功页面跳转地址 <br> <span style="color:#F00"> 示例：<a href="http://xxxx/xxxx">http://xxxx/xxxx</a></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;">submitUrl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>请求地址:<br>需通过from表单提交此地址，参数为submitParams<br><span style="color:#F00"> 示例：www.icbc.com，使用方式见文档底部</td>
</tr>
<tr>
<td style="text-align: left;">submitMethod</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>参数提交方式(忽略大小写)可选项如下:<br>get:GET方式提交<br>post:POST方式提交<br><span style="color:#F00"> 示例：POST</td>
</tr>
<tr>
<td style="text-align: left;">encoding</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>url编码方式<br><span style="color:#F00"> 示例：UTF-8</td>
</tr>
<tr>
<td style="text-align: left;">submitParams</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>请求参数<br>若未返回，则需根据submitUr、submitMethod进行组装<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;0000&quot;,
&quot;errMessage&quot;: &quot;成功&quot;,
&quot;submitUrl&quot;: &quot;www.icbc.com&quot;,
&quot;submitMethod&quot;: &quot;POST&quot;,
&quot;encoding&quot;: &quot;UTF-8&quot;,
&quot;submitParams&quot;: &quot;{\&quot;epccGwMsg\&quot;:\&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>
<td style="text-align: left;">&nbsp;</td>
</tr>
</tbody>
</table>
<h5>根据结果使用方式参考</h5>
<ol>
<li>action的值对应返回结果中的submitUrl</li>
<li>method的值对应返回结果中的submitMethod</li>
<li>input标签name值对应返回结果中submitParams下json传的key（submitParams.Key）</li>
<li>input标签value值对应返回结果中submitParams下json传的value（submitParams.Value）</li>
</ol>
<pre><code>&lt;form name=&quot;unionpay_punchout_form&quot; method=&quot;这里是submitMethod&quot; action=&quot;这里是submitUrl&quot;&gt;
&lt;input type=&quot;hidden&quot; name=&quot;epccGwMsg（这里是submitParams.key）&quot; value=&quot;这里是参数值(submitParams.value)&quot;&gt;
&lt;/form&gt;
&lt;script&gt;document.forms[0].submit();&lt;/script&gt;
</code></pre>