📄 正文
无论您是交易所、钱包还是平台方，都可以依赖一套标准化的错误码体系快速定位问题：DCS 所有 API 响应均采用统一格式，合作伙伴自管模式下的拒绝原因也以稳定的错误码返回，便于您在自有系统中做分支判断与用户引导。作为持牌、自有 BIN 的发卡机构，DCS 在授权、清算、对账各环节均保持一致的错误语义。 本页按场景整理合作伙伴自管接口的错误码，并为每类错误补充「可否重试 / 用户怎么办 / 能否补件」的处理建议，帮助接入机构区分系统级错误、参数与业务校验错误以及合作伙伴自管模式下的拒绝。统一响应结构
所有接口（无论成功或失败）都返回同一层 JSON 结构：
判断成功与否，请以
code 为准（成功为 SYS_SUCCESS，失败为本页枚举的 DAPI_* 码），不要依赖 message 文案，也不要假定 messageDetail 一定非空。
关于DAPI_前缀：本页这些码出现在响应结构的code字段，一律带DAPI_前缀。另有两类码不带前缀，因为它们出现在业务数据里而非结构：卡订单的data.errorCode（见卡申请错误码）与 KYC 工单的data.errorCode（见 KYC 拒绝码）。做分支判断时请按取值所在的位置选对写法。
messageDetail 与 message 的分工（失败时 messageDetail 是否必填）当前文档暂未明确。错误码分类
下表按场景整理全部DAPI_* 错误码，并为每类错误给出统一的处理建议；需要特别说明的错误码会单独列出。
1. 系统级错误（接入机构无法自行修复）
- 可否重试：
DAPI_SYSTEM_ERROR可在退避后重试；DAPI_OPERATION_NOT_SUPPORT/DAPI_PERMISSION_DENIED重试无意义。 - 用户怎么办：对终端用户提示「系统繁忙，请稍后再试」。
- 能否补件：不适用。
- 接入机构：持续出现请联系 DCS 排查，并核对账号开通的能力范围。
2. 鉴权与签名错误
- 可否重试：修正鉴权头后可重试；
DAPI_TIMESTAMP_EXPIRED需用新时间戳重新签名。 - 用户怎么办：与终端用户无关，属接入机构服务端配置问题。
- 能否补件：不适用。
- 接入机构：逐项核对鉴权请求头与签名规则，参见前置准备与鉴权指南。
Nonce 取值范围为
[10000, 99999]，与请求时间戳共同用于防重放校验；调用方不得复用 Nonce，并应对业务写操作另设幂等键。3. 参数与权限校验错误
- 可否重试：修正参数后可重试。
- 用户怎么办：不适用（服务端集成问题）。
- 能否补件：不适用。
- 接入机构：对照对应接口的参数表修正请求体。
4. 用户与企业相关错误
- 可否重试：格式类（
*_INVALID）修正后可重试；*_ALREADY_EXISTS/*_NOT_UNIQUE属幂等/唯一性冲突，应改用已存在的记录而非重复创建。 - 用户怎么办：邮箱/手机格式或已被占用时，引导用户更换或确认归属。
- 能否补件：不适用（属创建阶段校验）。
- 接入机构：
DAPI_CUSTOMER_REF_NOT_UNIQUE多因重复提交，建议改用查询已有用户。
5. KYC / 工单 / EDD 错误
- 可否重试：
DAPI_EXIST_ONGOING_TICKET_ERROR应等待现有工单结束再发起；DAPI_TICKET_REF_REPEATED改用已有工单；DAPI_TICKET_APPLY_LIMIT_EXCEEDED需退避后重试，不要立即重发。 - 用户怎么办：KYC 不通过时，引导用户根据拒绝原因补充资料（POI/POA）。POA 不通过时无需重新获取 Sumsub Token，直接通过补充接口提交。
- 能否补件：可补件——KYC/EDD 拒绝通常允许用户补充或更新材料后再次提交。
- 接入机构：KYC 流程与状态机参见 KYC 流程。
6. 卡订单 / 卡配置错误
- 可否重试：配置类（Profile/Layout/国家码不支持）需先在 DCS 侧确认配置，修正后重试；
*_REF_ALREADY_EXISTS改用已有订单；DAPI_CARD_APPLY_LIMIT_EXCEEDED需退避后重试，不要立即重发。 - 用户怎么办：通常无需用户介入；地区不支持时提示用户该卡种在其所在地暂不可用。
- 能否补件：不适用。
- 接入机构：公开开卡接口字段使用
profileId（企业余额查询使用同义字段cardProfileId）。当前没有在线查询接口，由 DCS 线下分配；不要在公开接口集成中使用内部别名categoryId。
7. 卡管理与卡状态错误
- 可否重试：状态不匹配类错误需先把卡流转到正确状态再操作，盲目重试无效。卡状态机见 卡管理。
- 用户怎么办：PIN 格式错误时提示用户重新输入 4 位数字；待激活卡需用户先激活。
- 能否补件：不适用。
- 接入机构：冻结/解冻同走一个接口
POST /open-api/card/v1/freeze，用布尔参数freeze区分（true=冻结，false=解冻）；操作前请先确认当前卡状态。
8. 引导页错误
- 可否重试：修正引导页参数后可重试。
- 用户怎么办：不适用（属接入机构生成链接时的参数问题）。
- 能否补件：不适用。
合作伙伴自管模式下的拒绝（重点）
在合作伙伴自管模式下，消费额度由接入机构掌握、授权由接入机构实时决策。当持卡人刷卡时，DCS 把授权请求转发给接入机构的授权回调地址（auth_url），由接入机构返回批准或拒绝。授权被拒时，拒绝原因通过 AUTHORISATION_RESULT Webhook 与每日授权报告的 rejectReason 字段返回，取值一律带 DAPI_ 前缀（生产示例："approveFlag":"D","rejectReason":"DAPI_SYSTEM_ERROR"）。完整枚举如下：
校验优先级固定为：卡状态 → KYC 消费限制 → 限额 → 企业回调 → 资金冻结；多个条件同时命中时，只返回最先命中的那一个。
- 可否重试：授权类拒绝属单笔交易结果，由持卡人在商户侧重新发起交易，接入机构不应对同一笔授权请求做服务端重试。
- 用户怎么办：
DAPI_AUTH_ENTERPRISE_REJECT多因接入机构侧额度不足或风控；请接入机构按自有规则向终端用户说明（如余额不足、超限）。 - 能否补件：不适用。
- 接入机构：超时拒绝（
*_TIMEOUT_REJECT）应排查授权回调的响应时延。生产环境授权同步应答窗口统一为 2.5 秒，接入机构必须在该窗口内同步返回。