Skip to content

Free Bet ​

INFO

Merchants can create and manage free bet activities through these APIs. A free bet activity gives selected players free rounds in one game. The player does not pay for a free round, and any winnings are real money.

  • Each activity is bound to one game and one currency. Free rounds can only be used in that game.
  • Merchants can only access their own activities and players. player_id is the merchant's own player ID.
  • After an activity is created its parameters cannot be changed. It can only be cancelled.
  • Create Activity must carry a unique request_id. A repeated request returns the result of the first one instead of creating a second activity.
  • When a free round is played, the debit, credit_n_settle and settle callbacks carry is_free_bet = true. See Debit.

Request Method ​

All APIs below use the same request method and signature as the other request APIs.

ItemNameSample
PathPath{Api_Address}/merchant/activity/create (see each API below)
Request MethodPOST

Time fields in requests and responses: start_time and end_time in the create request are strings in UTC format YYYY-MM-DDTHH:MM:SS. All other time fields are Unix timestamps in seconds.

Error Codes ​

Besides the common error codes, these APIs can return:

CodeDescription
100002Parameters error
100003Forbidden, the activity does not belong to this merchant
100004The game does not support free bet