银行卡四要素核验 · 待确认事项清单
致:银行卡四要素接口对接人 目的:在正式对接前厘清各业务状态码的触发条件与计费口径,确保我方对终端客户的答复准确无歧义。 字段:
result_code(主)/checkResultDetail(细分) 日期:2026-06-22
总问(最重要)
Q0|完整 result_code 全集:请提供所有可能返回的 result_code 完整清单,每个含:码值、含义、是否计费。
我方目前掌握 OK / FOURMETA_MATCH_FAIL / INITIALIZE_INVALID_*(姓名/证件/手机/卡号)/ INVALID_PARAM / CARD_NOT_SUPPORT / FOURMETA_HIGH_RISK_ERROR / OVER_DAILY_LIMIT / PRODUCT_NOT_OPEN / THIRDPARTY_ERROR / SYSTEM_ERROR / OVER_RATE_LIMIT。考虑到贵方为多供应商聚合,底层渠道可能透出未归一化的码,担心有遗漏,故需要全集。
逐项确认
| # | 问题 | 我方当前理解 / 拟处理方式 |
|---|---|---|
| 1 | CARD_NOT_SUPPORT 的真实触发条件(关键):对一张真实存在的非银联卡(如真实的境外 Mastercard / Visa 卡),贵方返回的是 CARD_NOT_SUPPORT 还是 FOURMETA_MATCH_FAIL?(注:用伪造卡号测试无法说明问题——查无此卡会走 MATCH_FAIL) |
假设返 CARD_NOT_SUPPORT 时按"不支持验证(发卡行不支持)"处理 |
| 2 | FOURMETA_HIGH_RISK_ERROR 是否仅频次:贵方此前书面答复"一般是相同证件号 / 相同卡号查询过于频繁"。请确认是否仅频次原因,**有无包含发卡行真实风险拦截(非频次)**的情况? |
暂按"查询频次超限"处理 |
| 3 | checkResultDetail 字段的完整取值:请列出该字段所有可能值及含义。特别确认 checkResultDetail=2 是否为"卡状态异常 或 不支持卡"的合并值(我方实测一张 52 段卡返 FOURMETA_MATCH_FAIL + checkResultDetail=2)。其它取值(如 1/3/4…)是否有独立含义? |
已观察 detail=2 含义不唯一;核验不通过统一按大类处理、不依赖该字段细分 |
| 4 | 计费场景:除 OK / FOURMETA_MATCH_FAIL 外,还有哪些 result_code 计费?CARD_NOT_SUPPORT、FOURMETA_HIGH_RISK_ERROR 是否计费? |
暂仅 OK / FOURMETA_MATCH_FAIL 计费 |
| 5 | 聚合底层码透传:底层不同供应商的原始码是否会未经归一化直接透出到 result_code?若会,能否提供这些透传码的清单? |
未列码统一按"数据源异常"兜底并告警 |
收尾
- 贵方状态码后续是否会新增或调整?若会,有无变更通知机制?
- 正式上线后首期能否提供一份按状态码维度的计费明细,供我方核对实际计费口径?
烦请逐项书面答复,谢谢配合。