充值 (Deposit)

接口说明

• 说明: 提交存款申请，支持手动银行转账或三方支付网关，并可附带申请相关充值红利活动。

底层业务逻辑与说明 (Business Logic)

NOTE

本接口承载了大量的风控及促销拦截逻辑，在转为纯 API 时请确保这部分业务规则同步生效：

1. 余额锁定 (Balance Lock)：如果后台开启，玩家余额超过阈值将无法存款。
2. 流水阻断 (Winover Block)：若玩家身上有未完成的存款流水任务，会被阻断，必须完成流水才能发起新存款。
3. 活动计算 (Promotion Turnover)：若前端传了 promote_id（或匹配了自动参与的活动），系统将通过 trigle_type（按本金/按红利/混合计算）乘以倍数计算所需流水。
4. 金额上下限校验：系统自动比对所选支付通道的 min_deposit 和 max_deposit。

---

1. POST - 提交充值申请

• 路径: /client/finance/deposit

请求头

参数名	类型	必填	说明
Authorization	String	是	Bearer Token

请求参数

参数名	类型	必填	说明
amt	Number	是	充值金额
currency	String	否	充值币种 (若不传，则默认取系统配置的默认币种)
payment_type	String	是	支付方式/通道的 Token
payment_bank	String	是	支付银行的 Token
promote_id	String	否	选择参与的活动 ID (若没有，则系统会自动尝试匹配可用的自动活动)

返回示例

{
  "code": 0,
  "msg": "充值申请已提交",
  "data": {
    "transaction_id": "20261122xxxx",
    "status": "Pending",
    "bonus_applied": 15.00
  }
}