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)

Player Related

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

Fund Related

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

Game Related

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)

Provider Related

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

Debugging and Troubleshooting Guide

When the API returns an error, the msg field may contain specific detailed descriptions to help operators or developers locate and fix configuration issues:

Error Message (Detailed msg)	Possible Cause	Troubleshooting Steps
agent has no access authorization for game_id xxx	The agent does not have access authorization for this game.	Check if the game is added to the agent's game access authorization list in Admin Panel.
agent brand route/mapping not configured for brand xxx	The merchant route/mapping for this game brand is missing.	Verify if the brand mapping (Route) is created in the merchant configuration panel.
currency XXX is not enabled/supported in brand YYY configurations	The target currency is not enabled for the brand.	Go to Admin Panel -> Provider Brand Settings, enable the target currency (e.g. IDR).
agent game commission rate not configured for currency XXX and game type YYY	Commission rate for the target currency and game type is missing.	Go to Agent Management -> Commission Rates, add a rate for the target currency and category (e.g. SLOT).
Call agent balance callback failed...	Core system failed to reach the integration callback server.	1. Check if the Callback URL (Base URL) is correct in Merchant Setup. 2. Verify if the callback server is online and white-listed IPs.
Player auto registration failed during game launch	Silent registration failed when launching a new user.	Database error or core system validation error. Please contact tech support.