# 充值大酬宾接口

**recharge_bonanza**

充值大酬宾的 `list` / `detail` 走通用活动接口（`kind=recharge_bonanza`，详见 [活动接口](400_promotion.md)）。**奖励由充值订单（`source=recharge_bonanza`）支付成功后自动发放**，玩家端不需要也无法手动领取（`POST /promotion/recharge_bonanza/claim` 始终返回错误「大酬宾奖励由充值订单自动发放」）。资格日按商户时区判定，玩家在资格日内充值达到任意档位即自动加赠。

---

## 活动详情字段 {#detail}

通用接口 `GET /promotion/recharge_bonanza/detail` 的 `data` 字段：

字段 | 类型 | 说明
---|---|---
description | string | 活动说明
weekdays | list<number\> | 资格日（按商户时区判定），取值 `0`(周日) ~ `6`(周六)
today_eligible | bool | 商户时区下今天是否为资格日
claimed_today | bool | 今天是否已经发放过加赠
bonus | number | 今天已发放的加赠金额（`claimed_today=true` 时有效）
min_tier_threshold | number | 最低档位充值门槛（即 `tiers[0].min_amount`），无档位时为 `0`
tiers | list<Tier\> | 加赠档位列表

`Tier` 字段：

字段 | 类型 | 说明
---|---|---
min_amount | number | 充值门槛（≥ 该值命中该档）
bonus | number | 加赠金额
bet_multiple | number | 该档加赠对应的打码倍数

未登录或会员不存在时，`claimed_today` 为 `false`、`bonus` 为 `0`。