1.4、绑定银行卡
<h2>1.4. 绑定银行卡</h2>
<h3>1.4.1. 获取支持的银行列表</h3>
<ul>
<li>请求路径:h5/bank/bankList</li>
<li>请求方法:get</li>
<li>请求参数</li>
</ul>
<p>无</p>
<ul>
<li>响应参数</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>参数说明 </th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>bankNo </td>
<td>银行编号 </td>
<td> </td>
</tr>
<tr>
<td>bankName</td>
<td>银行名称 </td>
<td> </td>
</tr>
<tr>
<td>banLogo </td>
<td>银行图标位置 </td>
<td> </td>
</tr>
</tbody>
</table>
<ul>
<li>响应数据</li>
</ul>
<pre><code class="language-json"> {
&quot;data&quot;: [
{
&quot;bankNo&quot;: 101,
&quot;bankName&quot;: &quot;中国银行&quot;,
&quot;banLogo&quot;: &quot;http://xxxxxx/xxx.png&quot;,
},
{
&quot;bankNo&quot;: 102,
&quot;bankName&quot;: &quot;建设银行&quot;,
&quot;banLogo&quot;: &quot;http://xxxxxx/xxx.png&quot;,
},
],
&quot;meta&quot;: {
&quot;msg&quot;: &quot;获取列表成功&quot;,
&quot;status&quot;: 200
}
}</code></pre>
<h3>1.4.2. 绑定银行卡申请</h3>
<ul>
<li>请求路径:h5/bank/bindBankCard</li>
<li>请求头:header:x-channel-code 固定传 A01</li>
<li>请求方法:post</li>
<li>请求参数</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>参数说明</th>
<th>备注 </th>
</tr>
</thead>
<tbody>
<tr>
<td>bankCardNo</td>
<td>银行卡号 </td>
<td>不能为空</td>
</tr>
<tr>
<td>bankCardType</td>
<td>银行卡类型 "1":储蓄卡,"2":信用卡 </td>
<td>不能为空</td>
</tr>
<tr>
<td>bankCode</td>
<td>银行编码(ABC,ICBC) </td>
<td>不能为空</td>
</tr>
<tr>
<td>reserveMobileNo</td>
<td>银行预留手机号 </td>
<td>不能为空</td>
</tr>
</tbody>
</table>
<ul>
<li>响应数据</li>
</ul>
<pre><code class="language-json">{
&quot;meta&quot;: {
&quot;msg&quot;: &quot;绑定成功&quot;,
&quot;status&quot;: 200
},
&quot;data&quot;:{
&quot;bankcardId&quot;:123//银行卡ID
}
}</code></pre>
<h3>1.4.3. 绑定银行卡确认</h3>
<ul>
<li>请求路径:h5/bank/confirmBankCard</li>
<li>请求头:header:x-channel-code 固定传 A01</li>
<li>请求方法:post</li>
<li>请求参数</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>参数说明</th>
<th>备注 </th>
</tr>
</thead>
<tbody>
<tr>
<td>bankcardId</td>
<td>银行卡ID </td>
<td>不能为空</td>
</tr>
<tr>
<td>smsCode</td>
<td>短信验证码 </td>
<td>不能为空</td>
</tr>
</tbody>
</table>
<ul>
<li>响应数据</li>
</ul>
<pre><code class="language-json">{
&quot;meta&quot;: {
&quot;msg&quot;: &quot;绑定成功&quot;,
&quot;status&quot;: 200
},
&quot;data&quot;:{
&quot;state&quot;:&quot;pass&quot;//pass:成功, fail:失败
}
}</code></pre>
<h3>1.4.4. 根据银行卡BIN查询所属银行</h3>
<ul>
<li>请求路径:h5/bank/queryBankByBin/{cardBin}</li>
<li>请求方法:get</li>
<li>请求参数</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>参数说明</th>
<th>备注 </th>
</tr>
</thead>
<tbody>
<tr>
<td>cardBin</td>
<td>卡BIN </td>
<td>银行卡前6位,不能为空</td>
</tr>
</tbody>
</table>
<ul>
<li>响应数据</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>参数说明</th>
<th>备注 </th>
</tr>
</thead>
<tbody>
<tr>
<td>cardBin</td>
<td>卡BIN </td>
<td>银行卡前6位</td>
</tr>
<tr>
<td>bankCode</td>
<td>银行编码 </td>
<td> </td>
</tr>
<tr>
<td>bankName</td>
<td>银行名称 </td>
<td> </td>
</tr>
<tr>
<td>bankCardType</td>
<td>卡类型 </td>
<td>银行卡类型(1储蓄卡2信用卡)</td>
</tr>
</tbody>
</table>
<ul>
<li>成功
<pre><code class="language-json">{
&quot;data&quot;: {
&quot;cardBin&quot;: &quot;625996&quot;,
&quot;bankCode&quot;: &quot;ABC&quot;,
&quot;bankName&quot;: &quot;中国农业银行&quot;,
&quot;bankCardType&quot;:&quot;2&quot;
},
&quot;meta&quot;: {
&quot;msg&quot;: &quot;查询成功&quot;,
&quot;status&quot;: 200
}
}</code></pre></li>
<li>
<p>失败</p>
<pre><code>{
&quot;data&quot;: null,
&quot;meta&quot;: {
&quot;msg&quot;: &quot;无银行信息&quot;,
&quot;status&quot;: 500
}
}</code></pre>
<h3>1.4.5. 获取已经绑定的银行卡</h3>
</li>
<li>请求路径:h5/bank/queryHadBind</li>
<li>请求头:header:x-channel-code 固定传 A01</li>
<li>请求方法:GET</li>
<li>
<p>请求参数</p>
</li>
<li>响应数据</li>
</ul>
<pre><code class="language-json">{
&quot;meta&quot;: {
&quot;msg&quot;: &quot;绑定成功&quot;,
&quot;status&quot;: 200
},
&quot;data&quot;: {
//【无绑卡记录,List为空】
&quot;bankCardList&quot;:[
{
&quot;bankCardId&quot;: 11111111,//绑卡Id
&quot;bankCardNo&quot;: &quot;62222222222&quot;,//银行卡号
&quot;bankName&quot;: &quot;中国银行&quot;,//银行名称
&quot;bankCode&quot;: &quot;123344&quot;,//银行代码
&quot;cardType&quot;: 1, //1: 借记卡 2: 信用卡
&quot;bindPhone&quot;:13888888888 //该卡绑定的客户手机号
&quot;bankLogo&quot;:&#039;&#039; //银行图标
},
{
&quot;bankCardId&quot;: 2222,//绑卡Id
&quot;bankCardNo&quot;: &quot;62222333333333&quot;,//银行卡号
&quot;bankName&quot;: &quot;中国银行&quot;,//银行名称
&quot;bankCode&quot;: &quot;123344&quot;,//银行代码
&quot;cardType&quot;: 1, //1: 借记卡 2: 信用卡
&quot;bindPhone&quot;:13888888888 //该卡绑定的客户手机号
&quot;bankLogo&quot;:&#039;&#039; //银行图标
},
]
}
}</code></pre>
<h3>1.4.6. 换卡申请</h3>
<ul>
<li>请求路径:h5/bank/replaceApply</li>
<li>请求头:header:x-channel-code 固定传 A01</li>
<li>请求方法:post</li>
<li>请求参数</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>参数说明</th>
<th>备注 </th>
</tr>
</thead>
<tbody>
<tr>
<td>bankCardNo</td>
<td>银行卡号 </td>
<td>不能为空</td>
</tr>
<tr>
<td>bankCardType</td>
<td>银行卡类型 "1":储蓄卡,"2":信用卡 </td>
<td>不能为空</td>
</tr>
<tr>
<td>bankCode</td>
<td>银行编码(ABC,ICBC) </td>
<td>不能为空</td>
</tr>
<tr>
<td>reserveMobileNo</td>
<td>银行预留手机号 </td>
<td>不能为空</td>
</tr>
<tr>
<td>oldBankcardId</td>
<td>旧卡ID </td>
<td>不能为空</td>
</tr>
<tr>
<td>loanNo</td>
<td>还款时换卡传借款订单号 </td>
<td>‘’</td>
</tr>
</tbody>
</table>
<ul>
<li>响应数据</li>
</ul>
<pre><code class="language-json">{
&quot;meta&quot;: {
&quot;msg&quot;: &quot;绑定成功&quot;,
&quot;status&quot;: 200
},
&quot;data&quot;:{
&quot;bankcardId&quot;:123//银行卡ID
}
}</code></pre>
<h3>1.4.7. 换卡确认</h3>
<ul>
<li>请求路径:h5/bank/replaceConfirm</li>
<li>请求头:header:x-channel-code 固定传 A01</li>
<li>请求方法:post</li>
<li>请求参数</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>参数说明</th>
<th>备注 </th>
</tr>
</thead>
<tbody>
<tr>
<td>bankcardId</td>
<td>银行卡ID </td>
<td>不能为空</td>
</tr>
<tr>
<td>smsCode</td>
<td>短信验证码 </td>
<td>不能为空</td>
</tr>
</tbody>
</table>
<ul>
<li>响应数据</li>
</ul>
<pre><code class="language-json">{
&quot;meta&quot;: {
&quot;msg&quot;: &quot;绑定成功&quot;,
&quot;status&quot;: 200
},
&quot;data&quot;:{
&quot;state&quot;:&quot;pass&quot;//pass:成功, fail:失败
}
}</code></pre>