详情版银行卡四要素API接口

详情版银行卡四要素

接口地址

https://tianyan.apistd.com/v2/bankcard4/detail/check

响应格式

application/json

请求方法

POST

请求参数 (Query)

参数名	类型	必须	描述
key`string`	`string`	是	请求 AccessKey, 请在控制台中查看
idcard`string`	`string`	是	身份证号码
name`string`	`string`	是	姓名
bankcard`string`	`string`	是	卡号
mobile`string`	`string`	是	银行预留手机号

返回参数 (Body)

参数名	类型	描述
success`boolean`	`boolean`	接口请求成功标识，true为成功，false为失败，失败情况下，会有对应描述和状态码
code`number`	`number`	成功为200，其它为失败状态码
msg`string`	`string`	code对应的说明描述
data`object`	`object`	验证结果详细信息
└ order_no`string`	`string`	订单号
└ result`number`	`number`	0 认证一致（收费），1 认证失败（收费），2未认证，3 已注销
└ desc`string`	`string`	验证结果描述信息

请求返回示例

{
  "msg": "",
  "success": true,
  "code": 200,
  "data": {
    "order_no": "654354493638578176",
    "result": 1,
    "desc": "手机号与银行预留信息不一致"
  }
}

验证开卡人银行卡卡号、身份证号码、姓名、手机号是否一致，根据银联风控要求，同一张卡24小时内验证次数不能超过5次，感谢您的配合

注意：北京银行、交行、邮储、平安（含原深发）、光大、兴业、浦发、东莞、中信、华夏、上海银行、农村信用合作社，以上银行卡需要先开通无卡支付功能后才能验证

用户见解

你也使用过这个API吗？欢迎分享你的见解

与大家分享你的见解、观点、比较或使用心得

错误码	描述
200	成功
400	参数错误
404	请求资源不存在
500	系统内部错误，请联系服务商
501	第三方服务异常
601	服务商未开通接口权限
602	账号停用
603	余额不足请充值
604	接口停用
1001	其他，以实际返回为准

const https = require('https');

const options = {
  'method': 'POST',
  'hostname': 'tianyan.apistd.com',
  'path': '/v2/bankcard4/detail/check?key=your_access_key_here&idcard=422***********0437&name=%25E9%25BB%258E*&bankcard=6212************647&mobile=132*******3'
};

const req = https.request(options, (res) => {
  const chunks = [];

  res.on("data", (chunk) => {
    chunks.push(chunk);
  });

  res.on("end", (chunk) => {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", (error) => {
    console.error(error);
  });
});

req.end();

* 以上示例代码仅供参考，建议根据您的实际业务场景及技术架构发起 HTTP API 请求