错误码

Agent Token 认证错误

错误信息	原因	解决方案
Authorization header is required	缺少 Authorization Header	添加 Authorization: Bearer {token}
Authorization header format must be Bearer {token}	Header 格式不正确	确认格式为 Bearer<空格>{token}
Invalid token format	Token 不是三段式	确认 Token 格式为 key.timestamp.signature
Invalid token: missing required parts	Token 某部分为空	检查各部分是否都有值
Invalid token: invalid timestamp	时间戳不是合法数字	确认 timestamp 为 Unix 秒级时间戳
Token expired	时间戳超出 ±2 分钟窗口	检查服务器时间，使用当前时间戳重新生成
Invalid agent credentials	API Key 无效或未找到	确认 agent_api_key 正确
Invalid token signature	签名不匹配	确认 agent_api_secret 正确，检查签名算法

通用错误码

错误码	Message	说明
0	success	成功
1001	err.param.invalid	参数缺失或格式错误
1002	err.signature.invalid	签名验证失败
1003	err.request.timeout	请求超时
1004	err.request.duplicate	重复请求（幂等性拦截）

玩家相关

错误码	Message	说明
2001	err.player.not_found	玩家不存在
2002	err.player.duplicate	玩家已存在（注册重复）
2003	err.player.disabled	玩家已被禁用
2004	err.player.password_invalid	密码错误
2005	err.player.register_failed	玩家注册失败
2006	err.player.member_id_invalid	member_id 格式错误

资金相关

错误码	Message	说明
3001	err.fund.insufficient_balance	余额不足
3002	err.fund.invalid_amount	转账金额无效（为 0 或超出限制）
3003	err.fund.duplicate_transfer	转账流水号重复
3004	err.fund.transfer_pending	转账处理中，请稍后查询
3005	err.fund.currency_not_supported	不支持的货币代码

游戏相关

错误码	Message	说明
4001	err.game.not_found	游戏不存在或已下线
4002	err.game.maintenance	游戏维护中
4003	err.game.type_unsupported	不支持的游戏类型
4004	err.game.platform_unsupported	不支持的平台类型
4005	err.game.launch_failed	游戏启动失败
4006	err.game.access_denied	游戏启动访问校验失败。请读取 msg 的具体原因：可能是游戏不支持该币种、代理币种未授权、品牌不支持该币种、未配置佣金费率或游戏未授权。

游戏商相关

错误码	Message	说明
5001	err.provider.unavailable	游戏商不可用
5002	err.provider.call_failed	游戏商接口调用失败
5003	err.provider.abnormal_response	游戏商返回异常
5004	err.provider.unsupported	不支持的游戏商
5005	err.provider.feature_unsupported	该游戏商不支持此功能

调试辅助说明（友善排错提示）

当游戏启动返回 code=4006 时，msg 会携带以下具体原因。请按 msg 修正配置；不要仅重试或重启服务。

错误信息 (msg 详细返回)	可能的原因	解决方案 (如何修复)
Current currency MYR is not supported	游戏自身的 currency_codes 不包含 MYR；该游戏不能以 MYR 启动。	先向游戏商确认该游戏是否支持 MYR。仅当游戏商确认支持后，才在游戏主数据加入 MYR。
Current currency MYR is not supported（ALL 游戏）	MYR 未在全局 Currency Management 启用；ALL 只会展开为全局已启用的实际币种。	在 Currency Management 启用 MYR；随后确认游戏列表中该游戏的 currency 已包含 MYR，再发起启动。
Current currency MYR is not authorized	Agent 的 Currency Access 已明确关闭 MYR。	在 Agent → Currency Access 启用 MYR。
Brand RICH88 does not support currency MYR	当前 Brand 未配置或不支持 MYR。	在 Provider / Brand 设置中为 RICH88 启用 MYR。
Current currency MYR has no configured commission rate	游戏支持 MYR，但 Agent 没有适用的 Provider / Brand / 游戏类型 / MYR 佣金 rate。	在 Agent → Commission Rate 新增或启用对应 MYR rate（例如 GSC / RICH88 / SLOT / MYR）。
Current game is not authorized	Agent Provider Route 未包含该游戏或 GSC 产品。	在 Agent → Provider Route 勾选并保存对应游戏或 GSC 产品。
GSC provider configuration is missing	平台未找到已启用的 GSC Provider 配置。	请联系平台管理员检查 GSC Provider 是否启用且配置完整。
Call agent balance callback failed...	本地核心系统去向包网发起“查分回调”时连接失败。	1. 检查商户设置中配置的回调域名（Base URL）是否正确。 2. 检查包网方自己的回调服务器是否在线、IP 白名单是否放行。
Player auto registration failed during game launch	首次启动游戏触发静默注册玩家失败。	数据库连接问题或核心系统校验失败，需联系技术人员排查日志。

All Currencies 佣金回退

Agent Commission Rate 中的 All Currencies 是所有具体币种均未命中时的回退规则；具体币种费率优先。它不启用币种，也不会绕过游戏、Brand 或 Agent 的币种权限。