Errors
In case of error, the object with the following structure is returned instead of expected response:
{
"error": {
"code": 6,
"message": "Invalid expiration date"
}
}
The response of that type means that an error occurred during the processing of the request.
Callback Error Codes
The following errors may occur when requests to the system methods are sent:
| Error code | Message | Description | Retry required |
|---|---|---|---|
| 1 | Insufficient funds | Not enough money on player’s wallet | - |
| 2 | Invalid signature | Authorization header is wrong | - |
| 3 | Token expired | Token session is expired | - |
| 4 | Unknown transaction id | The refTransactionId in a rollback request is incorrect or when validating the roundId for credit/rollback requests if there is no processed debit transaction for the round. Example: A debit transaction was not processed, but a rollback request references this unprocessed debit by its refTransactionId, resulting in error 4. Note: refTransactionId refers to the external ID of the transaction to be rolled back. | - |
| 5 | Invalid game | A game that is not available is used | - |
| 6 | Invalid amount | The amount is invalid in the transaction request | - |
| 7 | Invalid token | Wrong session token is used | - |
| 8 | Transaction already settled | [OBSOLETE] Occurs on attempt to repeatedly process a transaction with ID that has already been used | - |
| 9 | Debit transaction does not exist | Active debit transaction does not exist in the round. Example: If a credit transaction is sent without a preceding debit in the same round, error 9 is returned. | - |
| 10 | Limit exceeded | No bets can be placed by a player due to an exceeded limit | - |
| 11 | A transaction on a closed round is not allowed | A Game Provider is not allowed to make debit or credit transactions in the closed round | - |
| 400 | Invalid parameter | Wrong parameter | - |
| 900 | Internal server error | General error | + |
| 410 | Invalid used FreeSpin package ID | Invalid FreeSpins Package ID | - |
| 411 | Invalid used FreeSpins package quantity | Invalid FreeSpins quantity | - |
| 412 | Invalid status of FreeSpins package | FreeSpins package is not active | - |
| 414 | Transaction is pending | A transaction is being processed in another request | + |
Additional Reasons for Retries
If the error has a non-standard format, or the response was not received — for example, due to a timeout or an external server error — the request must be retried.
API Error Codes
| Error code | Description |
|---|---|
| 1 | General Error. Use it if no other errorCode is applicable |
| 2 | Invalid signature |
| 3 | The game is temporary unavailable |
| 4 | The game is currently unavailable for selected country |
| 5 | Currency is not supported |
| 6 | Invalid expiration date |
| 7 | Invalid request |
| 8 | Demo mode not supported |