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_idis 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.
| Item | Name | Sample |
|---|---|---|
| Path | Path | {Api_Address}/merchant/activity/create (see each API below) |
| Request Method | POST |
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:
| Code | Description |
|---|---|
| 100002 | Parameters error |
| 100003 | Forbidden, the activity does not belong to this merchant |
| 100004 | The game does not support free bet |