Error Codes Reference

This page lists all error codes that your system should return in response to EvenBet Seamless Wallet requests.

When an error occurs, your response must be in JSON format:

{
  "errorCode": 2,
  "errorDescription": "Player not found"
}

Response Requirements

Special handling required for these errors:

Error 0 with "Transaction already processed" → Return ALL parameters including balance
Error 3 (Insufficient funds) → Return ALL parameters including balance

All other errors: Return only errorCode and errorDescription

errorCode	errorDescription	Notes
0	Completed successfully	Also used for duplicate transactions with message "Transaction already processed"
1	Invalid signature	Verify `SEAMLESS_KEY` and SHA256 calculation. See Security.
2	Player not found	`userId` does not exist in your system
3	Insufficient funds	Must include `balance` in response. GetCash requests only.
4	Invalid request params	Missing required parameter, invalid currency code, or negative amount
5	Reference transaction does not exist	`referenceTransactionId` not found. Rollback requests only.
6	Reference transaction has incompatible data	Amount, currency, or `userId` mismatch with original transaction. Rollback requests only.
7	Wrong authentication / Session expired	Casino integration only