1)请求地址
https://v.1dq.com/api/bank/v3
2)示范URL
https://v.1dq.com/api/bank/v3?key=您的key&bankcard=62220211111&realName=张三&cardNo=123456789&cardtype=&information=
3)请求参数
字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
key |
string |
Y |
AppKey在我的数据页面 |
xxxxxx |
- |
bankcard |
string |
Y |
银行卡卡号 |
62220211111 |
- |
realName |
string |
Y |
身份证姓名 |
张三 |
- |
cardNo |
string |
Y |
身份证号码 |
123456789 |
- |
cardtype |
string |
N |
选填项,值为DC, 过滤信用卡验证;CC, 过滤借记卡验证 |
|
- |
information |
int |
N |
选填项,是否返回银行卡基本信息,如需要填写1, |
|
- |
4)选填参数
字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
trans_id |
string |
N |
用户订单号,24 字符以内 |
2017201230 |
- |
trans_date |
string |
N |
用户订单时间,格式为YYmmddHHiiss |
20160112122233 |
- |
trans_remark |
string |
N |
用户备注,原路返回 |
xxx |
- |
account |
string |
N |
是否返回账户信息 ,如需返回剩余可用次数,请传递auto如果账户是按次数扣除,则返回剩余次数如账户是按金额扣除,则返回账户剩余金额
|
auto |
- |
output |
string |
N |
输出格式,默认JSON;可选项JSON/XML |
JSON |
- |
5)返回参数
字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
error_code |
int |
Y |
状态码 |
- |
- |
reason |
string |
Y |
状态说明 |
- |
- |
ordersign |
string |
Y |
订单号 |
- |
- |
result |
string |
Y |
结果集 |
- |
- |
----bankname |
string |
- |
银行名称(中文) |
- |
- |
----enbankname |
string |
- |
银行名称(英文) |
- |
- |
----abbreviation |
string |
- |
银行简称 |
- |
- |
----cardprefixnum |
string |
- |
银行卡bin |
- |
- |
----cardprefixlength |
string |
- |
银行卡bin长度 |
- |
- |
----cardtype |
string |
- |
银行卡类型 |
- |
- |
----cardname |
string |
- |
银行卡名称 |
- |
- |
----cardlength |
string |
- |
银行卡长度 |
- |
- |
----isLuhn |
string |
- |
是否符合编码规范 |
- |
- |
----bankurl |
string |
- |
银行网址 |
- |
- |
----bankimage |
string |
- |
银行LOGO |
- |
- |
----servicephone |
string |
- |
银行电话 |
- |
- |
----iscreditcard |
string |
- |
是否是信用卡,1为借记卡,2为信用卡 |
- |
- |
6)返回JSON结果示例
{
"error_code": 0,
"reason": "认证通过",
"result": {
"realName": "王**",
"bankcard": "62284*****",
"cardNo": "5110*****",
"information": {
"abbreviation": "ABC",
"bankimage": "http://auth.apis.la/bank/3_ABC.png",
"bankname": "农业银行",
"banknum": "1030000",
"bankurl": "http://www.abchina.com/",
"cardlength": "19",
"cardname": "金穗通宝卡(银联卡)",
"cardprefixlength": "6",
"cardprefixnum": "622848",
"cardtype": "银联借记卡",
"enbankname": "Agricultural Bank of China",
"isLuhn": true,
"servicephone": "95599"
}
},
"ordersign": "cf9aba6cbb3f1a941a9391e8c8ee2d87"
}