- API
- 银行卡二要素核验
GET/bank2
无参数
无参数
- 接口文档
- 请求示例
- 成功响应
- 失败响应
- 错误码
- 调用结果
接口信息
https://paycard.market.alicloudapi.com/bank2
GET
JSON
API 简单身份认证调用方法(APPCODE)API 签名认证调用方法(AppKey & AppSecret)
接口参数
请求参数(Header)
字段名称 | 必填 | 字段详情 |
---|---|---|
无参数 |
请求参数(Query)
字段名称 | 必填 | 字段详情 |
---|---|---|
card string | Y | 银行卡卡号 实例值: 6259770289****** |
name string | Y | 持卡人真实姓名 实例值: 张三 |
请求参数(Body)
字段名称 | 必填 | 字段详情 |
---|---|---|
无参数 |
商品介绍
产品亮点
产品说明
产品概述:
银行卡二要素核验通过姓名、银行卡号比对核验银行卡信息真伪。直连银联,支持所有带银联标识的银行卡;官方权威核验,服务安全稳定,秒级响应,零缓存。
本软件已取得软件著作权登记号:2023SR1489643《 基于云市场API交付的银行卡各要素核验软件 》,提供高效、准确的银行卡各要素核验服务,助力企业高效合规地进行核验银行卡信息真伪。同时推出了《银行卡各要素核验API接口之云市场零代码调用平台》(软件著作权登记号:2023SR1486239),进一步降低了开发门槛,允许用户无需编写代码即可使用实名校验功能(具体与拇指云客服交流),极大地提升了开发效率与灵活性,满足了从专业开发者到普通用户的多样化需求。
Aliyun零代码调用平台URL: https://www.zpzzq.com/ali/cmapi00066830.do
使用说明: Aliyun零代码调用平台旨在为非技术背景人员如企业老板、采购经理、产品经理等带来极大便利,使你们能快速、直观地了解API的功能、性能等指标,掌握其核心功能,无需深入技术细节。促进产品团队与技术团队之间的沟通与协作,使双方能更高效地交流想法与需求,共同推动产品快速迭代与优化。降低部门沟通成本,提升企业整体运营效率与创新能力。建议收藏Aliyun零代码调用平台,我们不会保存您AppCode的重要凭证,请注意您浏览器Cookie的安全性,方可放心使用。
请求参数(Query):
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
银行卡卡号 | card | 是 | String(32) | 6259770289****** | 支持所有带银联标识的银行卡卡号 |
真实姓名 | name | 是 | String(32) | 张三 | 持卡人真实姓名 |
成功响应(Json):
{ "ok": 1, "msg": "校验完成", "card": "6259******111", "name": "张", "result": 1, "remark": "一致" } |
成功响应报文解释(Json):
字段名 | 类型 | 示例值 | 描述 |
---|---|---|---|
ok | number | 1 | 成功标识:1成功,0失败 |
msg | string | 校验完成 | 报文成败描述 |
card | string | 62357**********3533 | 银行卡卡号 |
name | string | 陈*香 | 持卡人真实姓名 |
result | number | 1 | 业务判断标识:1二要素一致,0二要素不一致,2无效卡号或卡状态异常 |
remark | string | 二要素一致 | 业务核查结果描述 |
失败响应(Json):
{ "ok": 0, "msg": "真实姓名有误,请检查" } |
失败响应报文解释(Json):
字段名 | 类型 | 示例值 | 描述 |
---|---|---|---|
ok | number | 0 | 成功标识:1查询成功,0失败(不计费) |
msg | string | 真实姓名有误,请检查 | 报文成败描述 |
常见的失败类型:
ok | msg | 解决方式 |
---|---|---|
0 | 未传入真实姓名name | 请传入真实姓名name |
0 | 未传入银行卡卡号card | 请传入银行卡卡号card |
0 | 传入真实姓名name字符串长度超限 | 不得超过32个字符 |
0 | 传入银行卡卡号card字符串长度超限 | 不得超过32个字符 |
0 | 姓名有误 | 检查传入的真实姓名信息 |
0 | 银行卡卡号有误 | 检查传入的银行卡卡号 |
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。
产品参数
交付方式 | API |
开票主体 | 拇指云(厦门)软件有限公司 |
所属类目 | 身份核验与金融银行 |
上架日期 | 2024-07-24 |
售后支持范围
产品资质
商品价格(此处价格仅供参考,实际价格以选配后的价格为准)
版本名称 | 计费项 | 新购 |
2元尝鲜 | 版本基础价格 | 2元 |
48元200次-0.24元/次 | 版本基础价格 | 48元 |
220元1千次-0.22元/次 | 版本基础价格 | 220元 |
2100元1万次-0.21元/次 | 版本基础价格 | 2100元 |
使用指南
立即下载服务商
拇指云(厦门)软件有限公司
- 数据与API
- 专业服务
用户评论 (2)
点赞,免开发调用
支持拇指云