提现 (Withdraw)

接口说明

• 说明: 提交提现申请，将账户余额提取到绑定的银行卡中。

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

WARNING

提现接口涉及核心资金安全，转为纯 API 时请务必保留原有的风控防线：

1. 未同步注单阻断 (Last Games Unsynced)：只要 ES 中有未同步完毕的注单，直接熔断接口，防时间差作弊。
2. 提现流水系统 (Winover & Turnover)：提现前严格校验 balance 是否大于用户身上背负的 sum_winover（未完成流水要求）。
3. 溢出没收机制 (Waive/Forfeit)：提现时会自动匹配红包或优惠活动配置的最高提款额 (final_max)。若申请提现的金额超出上限，超出部分将直接被没收 (Waive)。
4. 每日次数与额度限制：结合用户 VIP 等级，拦截超额、超次的提款申请。

---

1. POST - 提交提现申请

• 路径: /client/finance/withdraw

请求头

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

请求参数

参数名	类型	必填	说明
amt	Number	是	提现金额
currency	String	否	提现币种 (若不传，则默认取系统配置的默认币种)
payment_bank	String	是	支付通道支持的银行 Token/ID
bank_account	String	是	用户的银行账号

返回示例

{
  "code": 0,
  "msg": "提现申请已提交",
  "data": {
    "transaction_id": "W20261122xxxx",
    "actual_amount": 100.00,
    "waive_amount": 0.00
  }
}