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"
}