聚美智数


银行卡账户类型查询

<h3>接口描述</h3> <ul> <li>输入银行卡号,查询银行卡账户类型、归属地等信息</li> </ul> <h3>请求地址</h3> <p><code>https://api.jumdata.com/bankcard/type/query</code></p> <h3>请求方式</h3> <ul> <li>GET/POST</li> </ul> <h3>请求格式</h3> <ul> <li>x-www-form-urlencoded</li> </ul> <h3>请求参数</h3> <table> <thead> <tr> <th>名称</th> <th>类型</th> <th>必须</th> <th>&lt;div style=&quot;width:420px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>appId</td> <td>String</td> <td>是</td> <td>服务商分配的唯一标识</td> </tr> <tr> <td>timestamp</td> <td>Long</td> <td>是</td> <td>当前时间的毫秒数</td> </tr> <tr> <td>sign</td> <td>String</td> <td>是</td> <td>签名,详见签名算法说明</td> </tr> <tr> <td>bankcard</td> <td>String</td> <td>是</td> <td>银行卡号</td> </tr> </tbody> </table> <h3>签名算法说明</h3> <p><code>sign = sha256(appId + appSecret + timestamp)</code></p> <p>用服务商分配的 appId、服务商分配的 appSecret,当前时间毫秒数 timestamp,按上述顺序拼接成字符串,再进行 sha256 哈希得到。如下:</p> <pre><code class="language-java">String appId = &amp;quot;xyzxy2121zxyz&amp;quot;; String timestamp = &amp;quot;1555378976238&amp;quot;; String appSecret = &amp;quot;efcefcef1121cefcefc1212121&amp;quot;; String str = appId + appSecret + timestamp; String sign = sha256(str);</code></pre> <h3>成功返回样例</h3> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 200, // 返回码,详见返回码说明 &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;, // code对应的描述 &amp;quot;taskNo&amp;quot;: &amp;quot;10593189111578051288&amp;quot;, // 本次请求号 &amp;quot;charge&amp;quot;: true, // 计费标志 &amp;quot;data&amp;quot;: { &amp;quot;accountType&amp;quot;: &amp;quot;TYPE1&amp;quot;, // 账户类型,详见accountType字段说明 &amp;quot;province&amp;quot;: &amp;quot;浙江省&amp;quot;, // 所属省份 &amp;quot;city&amp;quot;: &amp;quot;杭州市&amp;quot;, // 所属城市 &amp;quot;bankcard&amp;quot;: &amp;quot;6014121212132803&amp;quot;, // 银行卡号 &amp;quot;bankname&amp;quot;: &amp;quot;中国交通银行&amp;quot;, // 银行名称 &amp;quot;cardtype&amp;quot;: &amp;quot;借记卡&amp;quot;, // 卡类型(借记卡/贷记卡/准贷记卡) &amp;quot;nature&amp;quot;: &amp;quot;太平洋万事顺卡&amp;quot;, // 卡名称 &amp;quot;abbreviation&amp;quot;: &amp;quot;BCM&amp;quot;, // 银行英文简写 &amp;quot;luhn&amp;quot;: &amp;quot;false&amp;quot;, // 是否支持luhn校验 true:是 false:否 &amp;quot;card_digits&amp;quot;: &amp;quot;12&amp;quot;, // 银行卡号长度 &amp;quot;card_bin&amp;quot;: &amp;quot;601428&amp;quot;, // 银行卡bin码 &amp;quot;bin_digits&amp;quot;: &amp;quot;6&amp;quot;, // 银行卡bin长度 } }</code></pre> <h3>失败返回样例</h3> <pre><code class="language-json">{ &amp;quot;msg&amp;quot;: &amp;quot;银行卡号不正确&amp;quot;, &amp;quot;code&amp;quot;: 400 }</code></pre> <h3>返回字段说明</h3> <table> <thead> <tr> <th>字段名</th> <th>&lt;div style=&quot;width:420px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>code</td> <td>返回码,详见返回码说明</td> </tr> <tr> <td>msg</td> <td>code对应的描述</td> </tr> <tr> <td>charge</td> <td>是否计费</td> </tr> <tr> <td>taskNo</td> <td>本次请求号</td> </tr> <tr> <td>data</td> <td>返回具体结果,详见成功返回样例</td> </tr> </tbody> </table> <h3>accountType字段说明</h3> <table> <thead> <tr> <th>字段名</th> <th>&lt;div style=&quot;width:420px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>TYPE0</td> <td>暂不支持该银行电子账户识别</td> </tr> <tr> <td>TYPE1</td> <td>疑似Ⅰ类银行账户(具有较高概率是Ⅰ类户)</td> </tr> <tr> <td>TYPE2</td> <td>确定性Ⅱ类银行账户(含线上渠道和柜面开立的Ⅱ类户两类)</td> </tr> <tr> <td>TYPE3</td> <td>确定性Ⅲ类银行账户(含线上渠道和柜面开立的Ⅲ类户两类)</td> </tr> <tr> <td>TYPE2_3</td> <td>Ⅱ类或Ⅲ类银行账户 (确定性非一类户,但不可具体区分Ⅱ类或Ⅲ类)</td> </tr> <tr> <td>TYPE4</td> <td>贷记卡</td> </tr> <tr> <td>TYPE7</td> <td>未知账户类型</td> </tr> </tbody> </table> <h3>code返回码说明</h3> <table> <thead> <tr> <th>code</th> <th>&lt;div style=&quot;width:420px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>200</td> <td>成功(计费)</td> </tr> <tr> <td>400</td> <td>参数错误</td> </tr> <tr> <td>404</td> <td>请求地址不正确</td> </tr> <tr> <td>500</td> <td>服务商维护,请稍候再试</td> </tr> <tr> <td>501</td> <td>官方数据源维护,请稍候再试</td> </tr> <tr> <td>601</td> <td>接口未开通</td> </tr> <tr> <td>602</td> <td>账号停用</td> </tr> <tr> <td>603</td> <td>余额不足请充值</td> </tr> <tr> <td>604</td> <td>接口停用</td> </tr> <tr> <td>606</td> <td>调用超限,请稍候再试</td> </tr> <tr> <td>607</td> <td>ip不在白名单</td> </tr> <tr> <td>609</td> <td>请求过于频繁,请稍候再试</td> </tr> <tr> <td>610</td> <td>请求超时</td> </tr> <tr> <td>999</td> <td>其他,以实际返回为准</td> </tr> </tbody> </table>

页面列表

ITEM_HTML