在金融和支付领域，获取银行卡的归属信息是一个常见的需求。**万维易源提供的“银行卡归属信息查询”API为开发者和企业提供了高效、便捷的银行卡信息查询服务，可以通过简单的接口调用获取银行卡的归属地、银行名称、电话号码、网址、卡种、银联Luhn效验和BIN码等详细信息。**本文将详细介绍如何使用该API，以及其核心功能和调用方法。
一、API概述
1. 接入点说明
- 功能：通过银行卡号查询银行卡的归属地，并附加返回卡号对应的地区、银行名、电话号码、网址、卡种、银联Luhn效验和BIN码等信息。当归属地查询失败时，不扣费。
- 用途：广泛应用于金融分析、支付系统、风险管理等场景，帮助用户快速获取银行卡的相关信息。
2. 接口地址
https://route.showapi.com/30-7?appKey={your_appKey}
请将 {your_appKey} 替换为你在万维易源平台申请的个人 appKey。
二、请求参数
以下是提交银行卡归属信息查询任务所需的请求参数：
| 参数名称 | 类型 | 示例值 | 必须 | 描述 |
|---|---|---|---|---|
| cardNum | String | 6228480402564890018 |
是 | 银行卡号。 |
| needBin | String | 1 |
否 | 是否需要返回银行卡BIN码信息和银联Luhn效验。1 表示需要，0 表示不需要，默认不会返回这些信息，返回这些信息将使得查询更加耗时。 |
三、返回参数
以下是接口返回的参数及其描述：
| 参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| ret_code | Number | 0 |
返回代码：0 表示成功，其他表示失败。 |
| area | String | 江苏省 - 苏州 |
地区。 |
| cardType | String | 借记卡 |
银行卡种。 |
| brand | String | 金穗通宝卡(银联卡) |
银行卡产品名称（品牌）。 |
| tel | String | 95599 |
银行客服电话。 |
| bankName | String | 中国农业银行 |
银行名称。 |
| url | String | www.abchina.com |
银行官网。 |
| simpleCode | String | ABC |
银行简码（该字段为银联支付网关简码，不一定有该字段返回）。 |
| formatBankName | String | 农业银行 |
规范化的银行名称，部分银行为空字符串。 |
| logo | String | http://app2.showapi.com/banklogo/abc.png |
银行logo，部分银行为空字符串。 |
| card_bin | String | 622848 |
银行卡BIN码（需要请求参数中 needBin=1 才有该值返回）。当无法查询到该银行卡BIN码时返回空字符串。 |
| bin_digits | String | 6 |
银行卡BIN码长度（需要请求参数中 needBin=1 才有该值返回）。 |
| card_digits | String | 19 |
银行卡卡号长度（需要请求参数中 needBin=1 才有该值返回）。 |
| isLuhn | String | 1 |
是否能通过中国银联Luhn效验，1 表示可以，0 表示不能，空字符串表示不支持（需要请求参数中 needBin=1 才有该值返回）。 |
四、调用示例
以下是一个使用 curl 命令调用该接口的示例：
curl 'https://route.showapi.com/30-7?appKey=your_appKey' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'needBin=1' \
-d 'cardNum=6228480402564890018'
请将 your_appKey 替换为你在万维易源平台申请的 appKey。
五、返回示例
以下是接口返回的JSON示例：
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id": "ce135f6739294c63be0c021b76b6fbff",
"showapi_res_body": {
"ret_code": 0,
"area": "江苏省 - 苏州",
"tel": "95599",
"brand": "金穗通宝卡(银联卡)",
"bankName": "中国农业银行",
"cardType": "借记卡",
"url": "www.abchina.com",
"cardNum": "622848***********018",
"simpleCode": "ABC",
"formatBankName": "农业银行",
"logo": "http://app2.showapi.com/banklogo/abc.png",
"card_bin": "622848",
"bin_digits": "6",
"card_digits": "19",
"isLuhn": "1"
}
}
六、获取 appKey
要获取 appKey，请访问万维易源的控制台页面：
查看 appKey
七、总结
万维易源的“银行卡归属信息查询”API为开发者和企业提供了一个高效、便捷的工具，可以通过简单的接口调用获取银行卡的详细信息。通过该API，可以快速查询银行卡的归属地、银行名称、电话号码、网址、卡种、银联Luhn效验和BIN码等信息，适用于金融分析、支付系统、风险管理等多种场景。希望本文能帮助你更好地了解和使用该API。如果你有任何问题或需要进一步的帮助，请随时访问万维易源的官方文档或联系技术支持。