登录注册

反馈

qq咨询联系

客服微信

商务微信

4009988033

银行卡归属地查询官方自营独立收费

累计调用

2亿+

查看演示

价格

产品说明
接口文档
帮助手册
产品价格
售后服务
常见问题
服务商资料

1、接口介绍

支持全国500多家银行卡基本资料查询（银行名称、卡类型（是借记卡还是信用卡），产品名称等。没有查到归属地则不扣次数）。支持10多家主流银行的归属地查询，比如中国银行、工行、农行、交通、建行、中信、招商、光大、兴业、民生、华夏、邮政储蓄、浦发银行卡等。查不到归属地不扣费。

2、使用场景

3、产品优势对比

4、我们的实力

让网络数据像水、电一样, 使用容易、自由和便宜

5、合作伙伴

已为3000多家企业提供API服务

一、接入点/ API point

银行卡归属信息查询

接入点说明：

通过银行卡号,查询银行卡的归属地,并附加返回卡号对应的地区\银行名\电话号码\网址\卡种\银联luhn\Bin码等信息.当归属地查询失败的时候,不扣费.

接口地址： https://route.showapi.com/30-7 （注意：接口也支持http协议，请根据自己的情况进行选择。）

返回格式： json

请求方式： HTTP协议，支持GET/POST方法。

API测试工具： 点此进入

查看加密签名方式二、请求参数/ Request parameter

非文件上传的POST时，请设置headers['Content-Type'] = 'application/x-www-form-urlencoded', 并把对象形式的数据转成查询字符串
文件上传的POST时，请设置headers['Content-Type'] = 'multipart/form-data'

1、系统级参数（所有接入点都需要的参数）：展开收起

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。可选【简单密钥方式】,在url后带上showapi_appid和showapi_sign即可
showapi_timestamp	String	20141114142239	否	客户端时间。格式yyyyMMddHHmmss,如20141114142239 为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：

参数名称	类型	默认值	示例值	必须	描述
cardNum	String		6228480402564890018	是	银行卡号
needBin	String	0	1	否	是否需要返回银行卡BIN码信息和银联luhn效验。1表示需要，0表示不需要，默认不会返回这些信息，返回这些信息将使得查询更加耗时。

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口 -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起

名称	类型	示例值	描述
area	String	江苏省 - 苏州	地区
cardType	String	借记卡	银行卡种
brand	String	金穗通宝卡(银联卡)	银行卡产品名称
tel	String	95599	银行客服
bankName	String	中国农业银行	银行名称
url	String	www.abchina.com	银行官网
ret_code	String	0	0为成功，其他失败
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才有该值返回）
...

四、请求示例/ Request example 查看使用向导 查看我的showapi_appid与showapi_sign 丨

五、返回示例/ Return example

{
	"showapi_res_code": 0,
	"showapi_res_error": "",
	"showapi_res_id":"ce135f6739294c63be0c021b76b6fbff",
    "showapi_res_body": {
		"ret_code": 0,
		"area": "江苏省 - 苏州",
		"tel": "95599",
		"brand": "金穗通宝卡(银联卡)",
		"bankName": "中国农业银行（01030000）",
		"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"
	}
}

客服公司电话：4009988033

本网站所列接口及文档全部由SHOWAPI网站提供，并对其拥有最终解释权 Powered By SHOWAPI

公司地址：昆明市五华区学府路745号海伦先生1栋1712号写字楼

易源·API市场

银行卡归属地查询 官方自营 独立收费