Create Activity
INFO
Creates a free bet activity and gives free rounds to the selected players. The activity is bound to one game and one currency. Its parameters cannot be changed after creation, it can only be cancelled. The request is idempotent on request_id.
Request Method
| Item | Name | Sample |
|---|---|---|
| Path | Path | {Api_Address}/merchant/activity/create |
| Request Method | POST |
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| Sign Params | Y | View details | |
| request_id | string | Y | Unique request ID, used for idempotency. A repeated request returns the result of the first one |
| activity_name | string | Y | Activity name, duplicates are allowed |
| player_id | array | Y | Player IDs that receive the free rounds, one or more |
| start_time | string | Y | Start of the usage period, YYYY-MM-DDTHH:MM:SS, UTC |
| end_time | string | Y | End of the usage period, YYYY-MM-DDTHH:MM:SS, UTC. Must be later than start_time |
| activity_type | string | Y | Currently only freebet |
| game_id | string | Y | Numeric game ID (the game_id from the Game List API). The activity is bound to this one game, which must support free bet |
| currency | string | Y | Currency of the bet |
| bet_amount | string | N | Bet amount of each free round. The player does not pay it. Defaults to the game's minimum bet |
| max_payout | string | N | Maximum payout of each free round. Defaults to the game's maximum payout |
| free_times | int | Y | Number of free rounds each player receives, greater than 0 |
Return Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| code | int | Y | 0 means success |
| msg | string | Y | Error description for the code |
| activity_id | string | Y | ID of the created activity |
Sample
Http Request
Post Method
URL : {Api_Address}/merchant/activity/create?mid=1697028447&sign=...&ts=1713768205
Content-Type：application/json
{"request_id":"req_20250620_001","activity_name":"Welcome bonus","player_id":["p456","p457"],"start_time":"2025-06-20T00:00:00","end_time":"2025-06-25T23:59:59","activity_type":"freebet","game_id":"10000","currency":"PHP","bet_amount":"0.2","max_payout":"10","free_times":5}
Http Response(success)
{"code":0,"msg":"","activity_id":"act_freebet456789"}