错误码与限流

你的钱包返回的问题码

整体请求失败使用 application/problem+json（RFC 9457），并带 code 字段：

code	HTTP	平台行为
invalid_signature	401	不重试；请检查密钥和服务器时钟。
invalid_launch_code	401	玩家看到进入失败，可重新打开游戏（新的启动码）。
malformed_request	400	不重试。
player_not_found	404	无法获取该玩家余额。
transaction_not_found	404	仅用于审计查询。
not_found	404	基础地址或路径错误。
rate_limited	429	等待 Retry-After 后以相同交易号重试。
unavailable	503	整批结果未知：等待 Retry-After 后以相同交易号重试；结果不确定的扣款会一直冲正直到 ok。
internal	500	以相同交易号重试。
—（超时、连接重置）	—	与 503 相同。

交易状态

HTTP 200 批量响应中的逐项结果：ok、insufficient_funds、session_invalid、player_blocked、limit_exceeded、duplicate_mismatch、reference_not_found、rolled_back、retry。含义和平台动作见钱包接口指南。

玩家看到的进入失败

情形	结果
getConfig 8 秒内未应答	页面显示进入失败。
你的钱包拒绝了启动码	页面显示进入失败；重新打开游戏会签发新启动码。
authenticate 时钱包不可达	页面显示进入失败。
你的生产环境被暂停	新会话被拒绝（operator_suspended）；进行中的对局照常结算。
投注时返回 insufficient_funds	该笔投注作废，游戏显示余额并可能调用 gameRecharge。

限流与容量

发往你的钱包。 平台不会超过你在「商户控制台 → 接入」声明的最大批量和最大并发请求。你返回 429 或 503 时，平台等待 Retry-After（秒）后再重试。你也可以返回 IETF RateLimit-Policy / RateLimit 头部，仅作参考。

面向玩家。 游戏平台对玩家操作有自己的按会话和按 IP 限流，你不需要做任何处理。

超时。 请尽快应答钱包请求——最好在几百毫秒内。下注期结束时仍未应答的批次按结果未知处理：其中的扣款作废并冲正。