Skip to main content

Error Codes Reference

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

HTTP Status Codes

The Evenbet system always responds with HTTP 200 for all callback responses, including errors. Error details are conveyed in the JSON response body (see format below). An HTTP 500 response indicates an internal server error on the Evenbet side and should be retried.

Error Response Format​

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

Error Codes​

errorCodeerrorDescriptionNotes
0Completed successfullyAlso used for duplicate transactions with message "Transaction already processed"
1Invalid signatureVerify SEAMLESS_KEY and SHA256 calculation. See Security.
2Player not founduserId does not exist in your system
3Insufficient fundsMust include balance in response. GetCash requests only.
4Invalid request paramsMissing required parameter, invalid currency code, or negative amount
5Reference transaction does not existreferenceTransactionId not found. Rollback requests only.
6Reference transaction has incompatible dataAmount, currency, or userId mismatch with original transaction. Rollback requests only.
7Wrong authentication / Session expiredCasino integration only