Usage List
INFO
GMP deducts the free rounds and records each usage by itself, no merchant callback is needed. Use this API to read the usage records, and round_id to reconcile with your own records.
Request Method
| Item | Name | Sample |
|---|---|---|
| Path | Path | {Api_Address}/merchant/activity/usage_list |
| Request Method | POST |
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| Sign Params | Y | View details | |
| activity_id | string | N | Filter by activity ID |
| player_id | string | N | Filter by player ID |
| offset | int | N | Paging offset, default 0 |
| limit | int | N | Page size, default 20, maximum 200 |
Return Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| code | int | Y | 0 means success |
| msg | string | Y | Error description for the code |
| total | int | Y | Total number of matching records |
| list | array | Y | Usage records |
| list[].activity_id | string | Y | Activity ID |
| list[].player_id | string | Y | Player ID |
| list[].game_id | string | Y | Game ID |
| list[].use_time | int | Y | Time of use, Unix seconds |
| list[].used_times | int | Y | Free rounds used by this record |
| list[].remaining_times | int | Y | Free rounds the player has left after this use |
| list[].bet_amount | string | Y | Bet amount of this free round |
| list[].reward_amount | string | Y | Payout of this free round, 0 means no win |
| list[].bet_mode | string | Y | Always free |
| list[].round_id | string | Y | Game round ID, used for reconciliation |
Sample
Http Request
Post Method
URL : {Api_Address}/merchant/activity/usage_list?mid=1697028447&sign=...&ts=1713768205
Content-Type：application/json
{"activity_id":"act_freebet456789","player_id":"p456","offset":0,"limit":20}
Http Response(success)
{"code":0,"msg":"","total":1,"list":[{"activity_id":"act_freebet456789","player_id":"p456","game_id":"10000","use_time":1750415400,"used_times":1,"remaining_times":4,"bet_amount":"0.2","reward_amount":"1.5","bet_mode":"free","round_id":"1797709382289"}]}