热门搜索 : 电子合同   签署   产品
首页 > 文档中心 > 银行卡三要素认证 > API接口文档

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

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

免费体验