企业银行卡账户验证V2
<h3>接口描述</h3>
<ul>
<li>验证企业银行卡账号、企业名称和企业法人信息是否一致</li>
<li>此接口会产生一次随机金额转账</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/bankcard/enterprise-account/validate/v2</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><div style="width:420px">说明</div></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>idType</td>
<td>String</td>
<td>是</td>
<td>企业代码类型，1:统一信用代码 3:工商注册号</td>
</tr>
<tr>
<td>idNo</td>
<td>String</td>
<td>是</td>
<td>企业代码，企业代码类型为 1 时，输入统一信用代码，企业代码类型为 3 时，输入工商注册号</td>
</tr>
<tr>
<td>enterpriseName</td>
<td>String</td>
<td>是</td>
<td>企业名称</td>
</tr>
<tr>
<td>legalPersonName</td>
<td>String</td>
<td>是</td>
<td>企业法人姓名</td>
</tr>
<tr>
<td>bankName</td>
<td>String</td>
<td>是</td>
<td>开户行名称, 需要银行列表里名称完全一致</td>
</tr>
<tr>
<td>enterpriseAccountNo</td>
<td>String</td>
<td>是</td>
<td>企业银行结算账号</td>
</tr>
</tbody>
</table>
<ul>
<li>企业银行卡验证银行列表 <a href="https://file.jumdata.com/support/企业银行卡验证银行列表-v2.xlsx">https://file.jumdata.com/support/企业银行卡验证银行列表-v2.xlsx</a></li>
</ul>
<h3>签名算法说明</h3>
<p><code>sign = sha256(appId + appSecret + timestamp)</code></p>
<p>用服务商分配的 appId、服务商分配的 appSecret，当前时间毫秒数 timestamp，按上述顺序拼接成字符串，再进行 sha256 哈希得到。如下：</p>
<pre><code class="language-java">String appId = "xyzxy2121zxyz"；
String timestamp = "1555378976238"；
String appSecret = "efcefcef1121cefcefc1212121"；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h3>成功返回样例</h3>
<pre><code class="language-json">{
"code": 200,
"msg": "成功",
"charge": true,
"taskNo": "69564903663951243279",
"data": {
"result": 1, // 详见result 返回字段说明
"resultMsg": "一致", // result的描述
"amount":12 // 随机转账金额，单位分。如转账未成功，不返回该字段
}
}</code></pre>
<h3>失败返回样例</h3>
<pre><code class="language-json">{
"msg": "企业名称不能为空",
"code": 400
}</code></pre>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></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>code返回码说明</h3>
<table>
<thead>
<tr>
<th>code</th>
<th><div style="width:420px">说明</div></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>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>
<h3>result 返回字段说明</h3>
<table>
<thead>
<tr>
<th>code</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>2</td>
<td>转账中，请查看银行账户</td>
</tr>
<tr>
<td>3</td>
<td>转账未成功，请联系开户行核实账户信息</td>
</tr>
<tr>
<td>4</td>
<td>付款银行名称有误</td>
</tr>
<tr>
<td>5</td>
<td>收款账户不支持此业务</td>
</tr>
<tr>
<td>6</td>
<td>收款方账户状态异常或已注销</td>
</tr>
<tr>
<td>7</td>
<td>银行查无此账号</td>
</tr>
<tr>
<td>8</td>
<td>收款账户名称和账户号码不一致</td>
</tr>
<tr>
<td>9</td>
<td>账户名称与银行记录不符</td>
</tr>
<tr>
<td>10</td>
<td>银行交易超时,请重试</td>
</tr>
<tr>
<td>11</td>
<td>未查到工商信息，请核对企业类型或上送的信息是否正确</td>
</tr>
<tr>
<td>12</td>
<td>企业名称和法人姓名不一致</td>
</tr>
<tr>
<td>13</td>
<td>企业名称不一致但法人姓名一致</td>
</tr>
<tr>
<td>14</td>
<td>企业名称一致但法人姓名不一致</td>
</tr>
<tr>
<td>15</td>
<td>转账未成功，请稍后重试</td>
</tr>
<tr>
<td>16</td>
<td>企业名称与法人信息不一致</td>
</tr>
</tbody>
</table>