免费投注
INFO
商户可通过以下接口创建和管理免费投注活动。活动会向指定玩家发放某款游戏的免费次数,玩家使用免费次数无需付费,所得奖金为真实可提现金额。
- 每个活动绑定一款游戏和一种币种,免费次数仅可在该游戏内使用。
- 商户只能操作自己的活动和玩家,
player_id为商户自己的玩家 ID。 - 活动创建后不能修改参数,只能取消。
- 创建活动必须携带唯一的
request_id。重复请求会返回第一次的结果,不会重复创建活动。 - 玩家使用免费次数时,debit、credit_n_settle、settle 回调会携带
is_free_bet = true,详见 扣款。
请求方式
以下接口的请求方式和签名与其他 Api 接口一致。
| Item | Name | Sample |
|---|---|---|
| Path | Path | {Api_Address}/merchant/activity/create(见下方各接口) |
| Request Method | POST |
时间字段说明:创建接口中的 start_time、end_time 为 UTC 字符串,格式 YYYY-MM-DDTHH:MM:SS;其余时间字段均为秒级 Unix 时间戳。
错误码
除通用错误码外,这些接口还可能返回:
| Code | Description |
|---|---|
| 100002 | 参数错误 |
| 100003 | 无权限,活动不属于该商户 |
| 100004 | 该游戏不支持免费投注 |