Errors

This section shows all Gameball common error codes and how to resolve them.

HTTP Status Codes

Gameball uses HTTP response status codes to indicate the success or failure of your API requests. If your request fails, Gameball returns an error using the appropriate status code.
  • 2XX codes indicate success and that the request worked as intended
  • 4XX codes indicate errors due to some mistakes in the request.
  • 5XX codes indicate an error with Gameball's servers.

Error Object

When an error occurs and the response code is 4XX, Gameball's servers send an Error Object that has two parameters, codeand message.

Example

{
"code": 15,
"message": "Name Already Exists"
}

Error Codes

Gameball sends an error code in the body of the response, each code has a corresponding error message that is descriptive of what went wrong, below are the codes along with their description.
Code
Message
Description
4
Missing Arguments
  • Missing parameter in the argument
  • Username is required for manual rewarding
  • Reason is required for manual rewarding
5
Null Arguments
The format is invalid or not compatible
7
Invalid Value
  • Value is in the wrong format, for example negative value for a payment
  • No level order was found matching the provided value
11
Hash Invalid
Hashed calculated is invalid or created in a wrong way
16
Inactive
Inactive element like a player or program that are inactive
17
Invalid Leveling Method
Different leveling method required to perform level update
101
Player External ID Not Found
Player does not exist
151
Referral Player Referred Already
Customer already exists and can not be referred
152
Referral Code Not Found
Referral code is wrong or nonexistent
301
Transaction Type Non Reversible
This transaction can not be canceled or reversed
302
Transaction Already Canceled
The transaction has already been canceled
303
Transaction Not Found
Transaction ID doesn't exist
304
Transaction Time Already Exists
A transaction was already done during the same exact time
305
Transaction ID Already Exists
Transaction ID must be unique, this ID already exists
306
Transaction Reversed ID Not Found
Reversed Transaction ID doesn't exist
307
Transaction Hold Reference Not Found
Transaction Hold Reference no longer exists. It is either wrong or it's been deleted after the 10-minute hold
351
Event Not Found
This event is not configured in the dashboard
The table covers all used errors and their description. If you get any error that is not listed above, please email us to add it.