【拇指云】银行卡三要素实名认证详版-银行卡实名认证接口（支持免开发调用）

　　产品概述：
　　银行卡三要素核验通过姓名、银行卡号、身份证号码比对核验银行卡信息真伪。直连银联，支持所有带银联标识的银行卡；官方权威核验，服务安全稳定，秒级响应，零缓存。
　　本软件已取得软件著作权登记号：2023SR1489643《 基于云市场API交付的银行卡各要素核验软件 》，提供高效、准确的银行卡各要素核验服务，助力企业高效合规地进行核验银行卡信息真伪。同时推出了《银行卡各要素核验API接口之云市场零代码调用平台》（软件著作权登记号：2023SR1486239），进一步降低了开发门槛，允许用户无需编写代码即可使用实名校验功能（具体与拇指云客服交流），极大地提升了开发效率与灵活性，满足了从专业开发者到普通用户的多样化需求。

　　Aliyun零代码调用平台URL： https://www.zpzzq.com/ali/cmapi00066831.do

　　使用说明： Aliyun零代码调用平台旨在为非技术背景人员如企业老板、采购经理、产品经理等带来极大便利，使你们能快速、直观地了解API的功能、性能等指标，掌握其核心功能，无需深入技术细节。促进产品团队与技术团队之间的沟通与协作，使双方能更高效地交流想法与需求，共同推动产品快速迭代与优化。降低部门沟通成本，提升企业整体运营效率与创新能力。建议收藏Aliyun零代码调用平台，我们不会保存您AppCode的重要凭证，请注意您浏览器Cookie的安全性，方可放心使用。

　　请求参数（Query）：

字段名	变量名	必填	类型	示例值	描述
银行卡卡号	card	是	String(32)	6259770289******	支持所有带银联标识的银行卡卡号
真实姓名	name	是	String(32)	张三	持卡人真实姓名
身份证号码	sfz	是	String(50)	35062319**********	持卡人身份证号码

 

　　成功响应（Json）：

 

{      "ok": 1,      "msg": "校验完成",      "name": "张*",      "sfz": "3506******1X",      "card": "6259******111",      "result": 1,      "remark": "一致"     }

 

　　成功响应报文解释（Json）：

 

字段名	类型	示例值	描述
ok	number	1	成功标识：1成功，0失败
msg	string	校验完成	报文成败描述
card	string	62357**********3533	银行卡卡号
sfz	string	3506******1X	身份证号码
name	string	陈*香	持卡人真实姓名
result	number	1	业务判断标识：1三要素一致，0三要素不一致，2无效卡号或卡状态异常
remark	string	三要素一致	业务核查结果描述

 

 

　　失败响应（Json）：

{      "ok": 0,      "msg": "未传入真实姓名name"     }

 

　　失败响应报文解释（Json）：

 

字段名	类型	示例值	描述
ok	number	0	成功标识：1查询成功，0失败（不计费）
msg	string	未传入真实姓名name	报文成败描述

　　常见的失败类型：

ok	msg	解决方式
0	未传入真实姓名name	请传入真实姓名name
0	未传入银行卡卡号card	请传入银行卡卡号card
0	未传入身份证号码sfz	请传入身份证号码sfz
0	传入真实姓名name字符串长度超限	不得超过32个字符
0	传入银行卡卡号card字符串长度超限	不得超过32个字符
0	传入身份证号码sfz字符串长度超限	不得超过20个字符
0	姓名有误	检查传入的真实姓名信息
0	银行卡卡号有误	检查传入的银行卡卡号
0	身份证号码有误	检查传入的身份证号码信息
1	核查结果：无效卡号或卡状态异常	检查传入的银行卡卡号是否有效
1	核查结果：无效的身份证号码	检查传入的身份证号码是否有效
1	核查结果：身份证与姓名不匹配	身份证与姓名不匹配，请检查
1	核查结果：不一致	核验结果不一致
0	未传入开发者账号appid	对接拇指云自研平台才出现：请传入appid开发者账号。
0	传入开发者账号appid字符串长度超限	对接拇指云自研平台才出现：appid字符串长度不得超过32个字符。
0	未传入查询时间sendtime	对接拇指云自研平台才出现：请传入sendtime时间戳。
0	传入查询时间sendtime字符串长度超限	对接拇指云自研平台才出现：请检查传入sendtime时间戳的长度。
0	时间戳超时，请重新请求	对接拇指云自研平台才出现：传入sendtime时间戳误差不得超过5分钟。
0	未传入签名sign	对接拇指云自研平台才出现：请传入sign签名结果。
0	传入签名sign字符串长度超限	对接拇指云自研平台才出现：请检查传入sign签名的长度。
0	签名校验失败	对接拇指云自研平台才出现：请参照平台签名校验流程进行对比调试。
0	存在*字符，视为调试数据。止于当前结果。	对接拇指云自研平台才出现：传入的参数值包含*字符，都将视为测试数据，仅用于调试。
0	非法来源	禁止将API用于任何形式的攻击行为，请注意。
0	appid:XXXXXXX接口已停用	对接拇指云自研平台才出现：XXXXXXX开发者已被拇指云停止调用。

　　1、次数扣减规则

　　阿里云的次数扣减规则基于http响应状态码执行，只有当http响应状态码为200~300范围内时，才会扣减调用次数。对于非200系列的响应状态码，您需要自行处理响应，并获取响应中的JSON数据。http响应状态码对照表请参考https://help.aliyun.com/document_detail/43906.html
　　若调用成功，返回的JSON数据包中的“OK”字段值为1，且http响应状态码为200。在这种情况下，阿里云会进行计费。
　　若调用失败，返回的JSON数据包中的“OK”字段值可能为0或其他非1的值，失败的具体原因会在“msg”字段中描述。此时http响应状态码被设置为666，阿里云不会对此次调用进行计费。
　　当调用次数用尽时，返回http响应状态码403，并附带消息“Quota Exhausted”。此时您只需续费即可恢复正常使用。

　　2、请求参数合法和准确性

　　① 开发者在使用API进行数据处理时，保证数据的准确性和完整性，不得进行任何篡改或伪造数据的行为。
　　② 在使用API的过程中，开发者应采取必要的安全措施，确保数据不被未授权访问或泄露，保障数据安全。
　　③ 开发者使用该接口时，确保遵守所有相关法律法规，不得将其用于任何非法或侵犯他人隐私的行为。
　　④ 开发者应定期对API的使用情况进行审计，确保使用行为始终符合规定要求，并进行必要的调整和改进。
　　⑤ 开发者不得将API用于任何形式的攻击行为，包括但不限于网络攻击、数据洪峰等。
　　⑥ 本接口适用于市场调研、商业合作、风险评估等多种场景，开发者可以根据实际需求合理使用。
　　⑦ 如发现API存在安全漏洞或潜在风险，开发者应立即停止使用并通知我们进行处理。
　　⑧ 开发者在使用API时，应尊重并保护我们的知识产权，不进行任何侵犯版权、商标等合法权益的行为。

　　1、消息提醒设置

　　您可以通过【消息中心·基本接收管理】https://notifications.console.aliyun.com/#/subscribeMsg进行相应设置，以避免因次数耗尽而影响业务运行。

　　2、发票开具与申请

　　您可以通过【费用与成本·发票管理】https://usercenter2.aliyun.com/invoice/create-by-detail/aliyun进行发票申请。我们将为您提供数电发票，支持普通电子发票和电子专票的开具。

　　3、开发密钥查看

　　您可以通过【已购买的服务】https://market.console.aliyun.com/imageconsole/index.htm 中对应我们的产品，查看AppKey/AppSecret或appCode。该界面您还可以查阅调用量、到期时间等概要信息。

　　4、服务热线

　　 有任何疑问或建议，欢迎拨打服务热线：4009030002 转16250，我们的服务时间为：工作日09:00-18:00。