热门搜索 : 电子合同   签署   产品
首页 > 文档中心 > 银行卡归属地查询 > API接口文档

1)请求地址

https://v.1dq.com/api/c43

2)示范URL

https://v.1dq.com/api/c43?key=您的key&bankcard=123456789&apiversion=2.0.5

3)请求参数

字段名称 类型 必填 字段说明 示范 备注
key string Y AppKey在我的数据页面 xxxxxx -
bankcard string Y 银行卡卡号 123456789 -
apiversion string N 版本,最新版为2.0.5 2.0.5 -

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 - 银行电话 - -
----province string - 归属地省 - -
----city string - 归属地市 - -
----iscreditcard string - 是否是信用卡,1为借记卡,2为信用卡 - -

6)返回JSON结果示例

{
  "error_code": 0,
  "reason": "Succes",
  "result": {
    "bankname": "工商银行",
    "banknum": "1020000",
    "cardprefixnum": "622202",
    "cardname": "E时代卡",
    "cardtype": "银联借记卡",
    "cardprefixlength": 6,
    "isLuhn": true,
    "iscreditcard": 1,
    "cardlength": 19,
    "province": "江苏省",
    "city": "南京市",
    "bankurl": "http://www.icbc.com.cn/",
    "enbankname": "Industrial and Commercial Bank of China",
    "abbreviation": "ICBC",
    "bankimage": "http://auth.apis.la/bank/1_ICBC.png",
    "servicephone": "95588"
  },
  "ordersign": "20180318125241001695753979"
}

现在注册,免费试用所有产品

免费体验