银行卡四要素核验 · 待确认事项清单(创蓝253)
致:创蓝253 银行卡四要素对接人 目的:在正式对接前厘清各业务状态码的触发条件与计费口径,确保我方对终端客户的答复准确无歧义。 接口:
wsauth.253.com/open/bankcard/card-auth(字段:code/data.result/data.innerresult/chargeStatus) 日期:2026-06-22
总问(最重要)
Q0|完整 innerresult 全集:请提供一级 result(01/02/03/04)下所有 innerresult 子码的完整清单,每个含:码值、中文含义、是否计费(chargeStatus)。
我方目前掌握的是 0101 / 0201 / 0202 / 0205 / 0206 / 0207 / 0301 / 0401 / 0402 / 0403,不确定是否还有其它码——若有遗漏,未知码在我方会走兜底逻辑、无法向客户解释,故需要全集。
逐项确认
| # | 问题 | 我方当前理解 / 拟处理方式 |
|---|---|---|
| 1 | 0401 的精确构成:贵方说明 0401 含"无效卡/证件/手机号有误 或 发卡行系统异常/超时"。其中"信息有误"属于核验不通过,"系统异常/超时"属于系统侧问题——这两类是否确实混在同一个 0401 里返回、无法区分?有没有更细的字段可以区分? |
暂统一按"核验不确定"处理 |
| 2 | 0301 与 0401 的区别:两者都表示"无法给出明确结论",请说明二者触发场景的本质区别(例如 0301 是否主要是"地方性银行信息未留"类)。 |
两者都按"核验不确定"处理 |
| 3 | 0207「该卡不支持认证」的具体原因:是"发卡行不支持该卡核验",还是"该核验要素组合不支持",还是其它? |
暂按"不支持验证"大类处理,不细分原因 |
| 4 | 400001(参数错)的 message 文案样例:请就"姓名 / 身份证 / 手机号 / 银行卡号"格式错,各提供一条真实返回的 message 原文,便于我方精确识别是哪个要素格式有误。 |
按 message 中是否含「姓名/身份证/手机号/银行卡」关键字分流 |
| 5 | 计费规则:是否完全以返回的 chargeStatus 为准、无任何例外?是否存在"chargeStatus=1 但实际不计费"或反向的情况? |
一律采信 chargeStatus(1 收费 / 0 不收费) |
| 6 | 合并码复核:请确认以下理解是否准确——0202 = 卡号无效 / 卡状态异常 / 密码超限的合并(跨银行口径不一);0201 = 认证未通过 / 未预留手机号;0205 = 卡状态异常(冻结 / 状态不正常 / 密码超限)。 |
按此理解落码 |
收尾
- 贵方状态码后续是否会新增或调整?若会,有无变更通知机制?
- 正式上线后首期能否提供一份按状态码维度的计费明细,供我方核对实际计费口径?
烦请逐项书面答复,谢谢配合。