银行卡四要素核验 · 待确认事项清单(365)
致:365 银行卡四要素对接人 目的:在正式对接前厘清各业务状态码的触发条件与计费口径,确保我方对终端客户的答复准确无歧义。 字段(三层):
error_code(系统层)/respCode(T/F/N/P)/detailCode(业务层) 日期:2026-06-22
总问(最重要)
Q0|完整三层码表:请提供 error_code、respCode、detailCode 三层的完整码表,每个 detailCode 含:码值、含义、对应 respCode、是否计费。
我方目前掌握 detailCode 0~15,不确定是否还有 >15 或其它码。
逐项确认
| # | 问题 | 我方当前理解 / 拟处理方式 |
|---|---|---|
| 1 | ⚠️ 计费口径冲突(最高优先级,请书面明确):贵方官方曾答复"error_code==0 即计费";但贵方接口文档逐码标注里,detailCode=3/4(发卡行不支持)标 N(不计费)、detailCode=7~10(要素格式错)标 F(不计费)——二者互相矛盾。请明确:detailCode=3 / 4 / 7 / 8 / 9 / 10 这几个到底计费还是不计费?最终以哪个口径为准? |
暂按"error_code==0 即计费"实现(即 3/4/7~10 均计费),与文档逐码标注相反,待对账核实 |
| 2 | detailCode=100「其他原因不通过」与 detailCode=1「信息有误」的区别:两者都表示核验未通过,请说明各自的触发场景区别。 |
都按"核验不一致"大类处理 |
| 3 | detailCode=12「银联渠道验证要素格式有误」与 7~10(具体字段格式错)的区别:何时返通用的 12、何时返具体的 7~10? |
12 → 笼统"参数格式有误";7~10 → 对应到具体要素 |
| 4 | detailCode 是否为成功响应必带字段:是否存在 error_code==0(成功)但响应不带 detailCode 的情况? |
假设"成功必带 detailCode";缺失即判响应不完整、按数据源异常处理且不计费 |
| 5 | error_code 系统层完整清单:请提供所有 error_code≠0 的码及含义。特别说明 10040「风险请求」的具体触发条件——是平台层风控,还是发卡行针对该卡的风控? |
仅 10035→同参超限、10022/10032/10039→配额耗尽,其余 error_code≠0 统一按数据源异常处理并告警 |
| 6 | 字段数据类型确认(联调):我方发现文档标注与实际不符——respCode/respMsg 标 Int 实为 String;bancardInfor 标 Int 实为对象;detailCode 带引号(如 "12")、error_code 不带引号。请确认各字段的实际数据类型。 |
已按"实际类型"解析,待联调最终验证 |
收尾
- 贵方状态码后续是否会新增或调整?若会,有无变更通知机制?
- 正式上线后首期能否提供一份按状态码维度的计费明细,供我方核对(第 1 项的计费口径尤其需要对账)?
烦请逐项书面答复,谢谢配合。