银行卡三要素

产品详情

提交查询

1、接口描述

请求支持 POST 和 GET 两种方法，字符编码为 utf-8。

2、请求地址

https://api.ihuyi.com/idcard/bank3/Submit.json

3、请求头说明

参数名称	参数值描述	示例	类型	必填
Content-Type	内容类型，固定值	application/x-www-form-urlencoded	string	是

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID（用户中心【认证核验】-【银行卡信息验证】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【认证核验】-【银行卡信息验证】-【产品总览】查看) 2、动态密码（生成动态密码方式请看该文档末尾的说明）	xxxxxxxxx	string	是
name	身份证姓名	张三	string	是
id_card_no	身份证号码	40122111******	string	是
bank_card_no	银行卡号	403925******	string	是
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示提交成功	2\|1	int	是
msg	提交结果描述	查询成功\|查询失败	string	是
idcardid	当提交成功后，此字段为流水号，否则为0或空	16236437872836\|0	string	否
result	认证结果		object	否
status	审核状态（0：未认证；1：认证未通过；2：认证通过）	2	string

6、响应状态码说明

code	msg
0	未知错误
1	提交失败
2	提交成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	应用不存在
404	姓名不能为空
4041	姓名格式不正确（2-10个中文汉字）
406	身份证号码不能为空
4061	身份证格式不正确
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
40505	没有签定合同
4051	剩余条数不足
4052	访问 ip 与备案 ip 不符
4086	通道无效
4201	访问失败
4202	请求超时
4203	系统异常
4204	用户验证失败
4205	查询无结果
4206	查询失败
4207	参数错误
4208	同一参数请求次数超限

7、GET传参示例

https://api.ihuyi.com/idcard/bank3/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&name=张三&id_card_no=40122111******&bank_card_no=403925******&

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>查询成功</msg><idcardid>16236437872836</idcardid><result><status>2</status></result></SubmitResult>

{    "code":
            2
        ,        "msg":
            "查询成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "status":
                "2"
                        }
                }

示例（失败）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>查询失败</msg></SubmitResult>

{"code":1,"msg":"查询失败"}

9、PHP生成动态密码方式代码示例

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'bank3'; //固定值
$name = '张三';
$id_card_no = '40122111******';
$bank_card_no = '403925******';
$time = '1623643787';
$password=md5($account.$password.$app.$name.$id_card_no.$bank_card_no.$time);
$password=md5('xxxxxxxxxxxxxxxxxbank3张三40122111******403925******1623643787');

//注意：所有字符编码统一为UTF-8

银行卡三要素

提交查询

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

9、PHP生成动态密码方式代码示例

10、代码示例

免费体验

填写验证码后，点击“开通体验账户”自动开通体验账户。