兄弟公司前端接口

后端接口api返回数据格式


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">  {     &amp;quot;data&amp;quot;: [         {             &amp;quot;bankNo&amp;quot;: 101,             &amp;quot;bankName&amp;quot;: &amp;quot;中国银行&amp;quot;,             &amp;quot;banLogo&amp;quot;: &amp;quot;http://xxxxxx/xxx.png&amp;quot;,         },         {             &amp;quot;bankNo&amp;quot;: 102,             &amp;quot;bankName&amp;quot;: &amp;quot;建设银行&amp;quot;,             &amp;quot;banLogo&amp;quot;: &amp;quot;http://xxxxxx/xxx.png&amp;quot;,         },     ],     &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;获取列表成功&amp;quot;,         &amp;quot;status&amp;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>银行卡类型 &quot;1&quot;:储蓄卡,&quot;2&quot;:信用卡    </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">{     &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;绑定成功&amp;quot;,         &amp;quot;status&amp;quot;: 200     }, &amp;quot;data&amp;quot;:{ &amp;quot;bankcardId&amp;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">{     &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;绑定成功&amp;quot;,         &amp;quot;status&amp;quot;: 200     }, &amp;quot;data&amp;quot;:{ &amp;quot;state&amp;quot;:&amp;quot;pass&amp;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">{     &amp;quot;data&amp;quot;: {         &amp;quot;cardBin&amp;quot;: &amp;quot;625996&amp;quot;,         &amp;quot;bankCode&amp;quot;: &amp;quot;ABC&amp;quot;,         &amp;quot;bankName&amp;quot;: &amp;quot;中国农业银行&amp;quot;, &amp;quot;bankCardType&amp;quot;:&amp;quot;2&amp;quot;     },     &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;查询成功&amp;quot;,         &amp;quot;status&amp;quot;: 200     } }</code></pre></li> <li> <p>失败</p> <pre><code>{     &amp;quot;data&amp;quot;: null,     &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;无银行信息&amp;quot;,         &amp;quot;status&amp;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">{     &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;绑定成功&amp;quot;,         &amp;quot;status&amp;quot;: 200     },     &amp;quot;data&amp;quot;: {         //【无绑卡记录,List为空】         &amp;quot;bankCardList&amp;quot;:[             {                 &amp;quot;bankCardId&amp;quot;: 11111111,//绑卡Id                 &amp;quot;bankCardNo&amp;quot;: &amp;quot;62222222222&amp;quot;,//银行卡号                 &amp;quot;bankName&amp;quot;: &amp;quot;中国银行&amp;quot;,//银行名称                 &amp;quot;bankCode&amp;quot;: &amp;quot;123344&amp;quot;,//银行代码                 &amp;quot;cardType&amp;quot;: 1,  //1: 借记卡 2: 信用卡 &amp;quot;bindPhone&amp;quot;:13888888888 //该卡绑定的客户手机号 &amp;quot;bankLogo&amp;quot;:&amp;#039;&amp;#039; //银行图标             },             {                 &amp;quot;bankCardId&amp;quot;: 2222,//绑卡Id                 &amp;quot;bankCardNo&amp;quot;: &amp;quot;62222333333333&amp;quot;,//银行卡号                 &amp;quot;bankName&amp;quot;: &amp;quot;中国银行&amp;quot;,//银行名称                 &amp;quot;bankCode&amp;quot;: &amp;quot;123344&amp;quot;,//银行代码                 &amp;quot;cardType&amp;quot;: 1,  //1: 借记卡 2: 信用卡 &amp;quot;bindPhone&amp;quot;:13888888888 //该卡绑定的客户手机号 &amp;quot;bankLogo&amp;quot;:&amp;#039;&amp;#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>银行卡类型 &quot;1&quot;:储蓄卡,&quot;2&quot;:信用卡    </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">{     &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;绑定成功&amp;quot;,         &amp;quot;status&amp;quot;: 200     }, &amp;quot;data&amp;quot;:{ &amp;quot;bankcardId&amp;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">{     &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;绑定成功&amp;quot;,         &amp;quot;status&amp;quot;: 200     }, &amp;quot;data&amp;quot;:{ &amp;quot;state&amp;quot;:&amp;quot;pass&amp;quot;//pass:成功, fail:失败 } }</code></pre>

页面列表

ITEM_HTML