热门搜索 : 电子合同   签署   产品
首页 > 文档中心 > 银行卡信息核验 > API接口文档

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

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

免费体验