1)请求地址
https://v.1dq.com/api/bank/v0
2)示范URL
https://v.1dq.com/api/bank/v0?key=您的key&bankcard=62220211111&realName=张三&cardNo=12345678&Mobile=15618181818&cardtype=&information=&cardclass=
3)请求参数
字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
key |
string |
Y |
AppKey在我的数据页面 |
xxxxxx |
- |
bankcard |
string |
Y |
银行卡卡号 |
62220211111 |
- |
realName |
string |
Y |
身份证姓名;选填项, |
张三 |
- |
cardNo |
string |
N |
身份证号码;选填项 |
12345678 |
- |
Mobile |
string |
N |
手机号码;选填项 |
15618181818 |
- |
cardtype |
string |
N |
选填项,值为DC, 过滤信用卡验证;CC, 过滤借记卡验证 |
|
- |
information |
int |
N |
选填项,是否返回银行卡基本信息,如需要填写1, |
|
- |
cardclass |
int |
N |
证件类型,1身份证,2军官证,3护照 |
|
- |
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": {
"bankcard": "62220210",
"information": {
"abbreviation": "ICBC",
"bankimage": "http://auth.apis.la/bank/1_ICBC.png",
"bankname": "工商银行",
"banknum": "1020000",
"bankurl": "http://www.icbc.com.cn/",
"cardlength": "19",
"cardname": "E时代卡",
"cardprefixlength": "6",
"cardprefixnum": "622202",
"cardtype": "银联借记卡",
"enbankname": "Industrial and Commercial Bank of China",
"isLuhn": true,
"iscreditcard": 1,
"servicephone": "95588"
}
},
"ordersign": "2017061218205316653545354"
}