Gameball Developers Guide
v3.0
Ask or search…
K

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
3
Not Found
Challenge is not found
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
10
Forbidden
The body hash for client registration is not valid
11
Hash Invalid
Hashed calculated is invalid or created in a wrong way
12
Name Length Invalid
The provided name does not meet the required character limit
13
Something Wrong
An unexpected error occurred while processing your request.
14
Name Already Exists
The name provided is already registered in our system
15
Email Already Exists
The email address provided is already registered in our system.
16
Inactive
Inactive element like a player or program that are inactive
17
Invalid Leveling Method
Different leveling method required to perform level update
50
Gameball Is Disabled
Gameball is disabled
51
Cashback Is Disabled
Cashback points program is disabled
101
Player External ID Not Found
Player does not exist
102
Player Already Exists
The player you are trying to create already exists
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
308
Invalid Transaction Time
Invalid Transaction Date. An order for the same Transaction Date has already been placed within the same second.
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.