在金融和支付领域，获取银行卡的归属信息是一个常见的需求。**万维易源提供的“银行卡归属信息查询”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。如果你有任何问题或需要进一步的帮助，请随时访问万维易源的官方文档或联系技术支持。
