Error Codes

Agent Token Authentication Errors

Error Message	Cause	Solution
`Authorization header is required`	Missing Authorization header	Add `Authorization: Bearer {token}`
`Authorization header format must be Bearer {token}`	Incorrect header format	Confirm format is `Bearer<space>{token}`
`Invalid token format`	Token is not three-part	Confirm Token format is `key.timestamp.signature`
`Invalid token: missing required parts`	Token has empty parts	Check all parts have values
`Invalid token: invalid timestamp`	Timestamp is not a valid number	Confirm timestamp is Unix seconds
`Token expired`	Timestamp outside ±2 min window	Check server time, regenerate with current timestamp
`Invalid agent credentials`	API Key invalid or not found	Verify `agent_api_key` is correct
`Invalid token signature`	Signature mismatch	Verify `agent_api_secret` is correct, check signing algorithm

General Error Codes

Code	Message	Description
`0`	`success`	Success
`1001`	`err.param.invalid`	Parameter missing or invalid format
`1002`	`err.signature.invalid`	Signature verification failed
`1003`	`err.request.timeout`	Request timeout
`1004`	`err.request.duplicate`	Duplicate request (idempotency)

Code	Message	Description
`2001`	`err.player.not_found`	Player not found
`2002`	`err.player.duplicate`	Player already exists (duplicate registration)
`2003`	`err.player.disabled`	Player has been disabled
`2004`	`err.player.password_invalid`	Invalid password
`2005`	`err.player.register_failed`	Player registration failed
`2006`	`err.player.member_id_invalid`	Invalid member_id format

Code	Message	Description
`3001`	`err.fund.insufficient_balance`	Insufficient balance
`3002`	`err.fund.invalid_amount`	Invalid transfer amount (zero or exceeds limit)
`3003`	`err.fund.duplicate_transfer`	Duplicate transfer reference
`3004`	`err.fund.transfer_pending`	Transfer in progress, please query later
`3005`	`err.fund.currency_not_supported`	Currency not supported

Code	Message	Description
`4001`	`err.game.not_found`	Game not found or offline
`4002`	`err.game.maintenance`	Game under maintenance
`4003`	`err.game.type_unsupported`	Unsupported game type
`4004`	`err.game.platform_unsupported`	Unsupported platform type
`4005`	`err.game.launch_failed`	Game launch failed
`4006`	`err.game.access_denied`	Game access denied (agent does not have permission for this game)

Code	Message	Description
`5001`	`err.provider.unavailable`	Provider unavailable
`5002`	`err.provider.call_failed`	Provider API call failed
`5003`	`err.provider.abnormal_response`	Provider returned abnormal response
`5004`	`err.provider.unsupported`	Unsupported provider
`5005`	`err.provider.feature_unsupported`	Provider does not support this feature