Free Bets

This section describes how to use the Free Bets feature. The endpoint allows customer platform users to access and redeem free bets granted by the Hypetech system. These free bets can be used as promotional credits to encourage user engagement and participation without risking their actual balance.

To enable this feature, ensure that the free bet configurations are correctly set up. For additional support, contact the Hypetech team through the email provided in the documentation header.

Redeem Free Bet POST

This endpoint is used to redeem a free bet for a user. Once redeemed, the free bet amount is credited to the user's account, and it can be used for betting in the specified games.

Authorizations: `accessToken`

HTTP: accessToken

Token generated through the Hypetech administrative panel to authenticate requests for free bets.

HTTP Authorization Scheme: Bearer

Request Body schema: `application/json`

Request Fields

Field	Type	Description
game_slug	string	Unique identifier for the game where the free bet will be applied.
user_id	string	Specifies the user id on the client platform. This parameter will be used to check balance, withdrawal and confirm bet results using webhooks.
quantity	string	Defines the number of free bets to be credited to the user.
value	double	Specifies the value of each free bet in the defined currency.
currency	string	Specifies the currency that will be used during bets.
expires_at	string	Defines the expiration date and time for the free bet in ISO 8601 format (e.g., "2024-12-31T23:59:59Z").
bonus_code	string	An optional promotional code linked to the free bet offer. This field is nullable and can be left empty if not applicable.

Example Payload

Content type: application/json

            {
            "game_slug": "aviator",
            "user_id": "99e27bf0-35da-46e2-a82d-07c492d1ed25",
            "quantity": "5",
            "value": 10.0,
            "currency": "USD",
            "expires_at": "2024-12-31T23:59:59Z",
            "bonus_code": "FREEBET2024"
            }

Response Samples

Content type: application/json

201 - Success "Successfully created a new free bet.

RESPONSE SCHEMA: application/json

Field	Type	Description
`free_bet`	string	Details of the newly created free bet.

{
"free_bet": "New free bet created successfully."
}

401 Not authorized

RESPONSE SCHEMA: application/json

Field	Type	Description
`title`	string	Error title.
`statusCode`	integer	HTTP code for returned status.

{
"title": "Unauthorized",
"statusCode": 401,
}

404 Not found.

RESPONSE SCHEMA: application/json

Field	Type	Description
`title`	string	Error title.
`statusCode`	integer	HTTP code for returned status.

{
"title": "Not found",
"statusCode": 404,
}

500 Internal server error.

RESPONSE SCHEMA: application/json

Field	Type	Description
`title`	string	Error title.
`statusCode`	integer	HTTP code for returned status.

{
"title": "Invalid Operation.",
"statusCode": 500,
}

Free Bets

Redeem Free Bet POST

Authorizations: accessToken

HTTP: accessToken

Request Body schema: application/json

Authorizations: `accessToken`

Request Body schema: `application/json`