银行卡四要素核验 · 待确认事项清单

更新于 2026-06-22

银行卡四要素核验 · 待确认事项清单

致:银行卡四要素接口对接人 目的:在正式对接前厘清各业务状态码的触发条件与计费口径,确保我方对终端客户的答复准确无歧义。 字段: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?若会,能否提供这些透传码的清单? 未列码统一按"数据源异常"兜底并告警

收尾

  1. 贵方状态码后续是否会新增或调整?若会,有无变更通知机制?
  2. 正式上线后首期能否提供一份按状态码维度的计费明细,供我方核对实际计费口径?

烦请逐项书面答复,谢谢配合。