1. 获取提现统计

接口地址： /merchantapi/wallet/cash/gettotalcash

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "total_cash": "10000.00",
    "today_cash": "500.00"
  }
}

字段说明：

• total_cash: 商户总提现金额（已成功提现的总额）
• today_cash: 商户今日提现金额

---

2. 获取收款设置

接口地址： /merchantapi/wallet/cash/getcollect

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "cash_type": 2, // 商户当前设置的收款方式 1=自动提现 2=手动提现 3=定时提现 10分钟运行一次定时提现
    "cashTypesOptions": [
      // 平台已开启的收款方式列表
      {
        "value": 1,
        "label": "支付宝"
      },
      {
        "value": 2,
        "label": "微信"
      },
      {
        "value": 3,
        "label": "银行卡"
      },
      {
        "value": 4,
        "label": "USDT"
      }
    ],
    "info": {
      "id": 2, // 收款信息ID
      "user_id": 1000, // 商户ID
      "type": 4, // 收款方式类型 1=支付宝 2=微信 3=银行卡 4=USDT
      "info": {
        // 收款信息
        "bank_name": "", // 银行名称 type=3时为银行名称，其余时不建议显示及提交
        "bank_branch": "", // 开户支行 type=3时为开户支行，其余时不建议显示及提交
        "account": "3", // 收款账号 type=1时为支付宝账号 type=2时为微信账号 type=3时为银行卡号 type=4时为USDT地址
        "realname": "", // 收款人真实姓名 type=1时为支付宝姓名 type=2时为微信姓名 type=3时为银行卡户名 type=4时不必填
        "idcard_number": "" // 身份证号 type=4时不必填
      },
      "create_at": "2025-11-19 03:01:19", // 创建时间
      "collect_img": "", // 收款二维码图片URL(非必须) 
      "status": 1 // 状态 0-禁用，1-启用
    }
  }
}

---

3. 设置提现地址

首次绑定、修改地址均需邮箱验证，不再使用二级密码。

先调用 POST /merchantapi/wallet/cash/sendCollectEmailCode（无需参数），验证码只发送至当前登录商户的已绑定邮箱。 验证码有效期 5 分钟，60 秒内不可重复发送；错误 5 次后失效，验证成功即作废。 验证码与商户 ID、当前邮箱及地址保存用途绑定，不能使用绑定邮箱或重置密码的验证码代替。 随后将验证码与地址一并提交至下方接口；保存失败且验证码已使用时需要重新获取。

接口地址： /merchantapi/wallet/cash/setCollect

请求方式： POST

请求参数：

参数名	类型	必填	说明
type	int	是	收款方式类型 1=支付宝 2=微信 3=银行卡 4=USDT
account	string	是	收款账号 type=1时为支付宝账号 type=2时为微信账号 type=3时为银行卡号 type=4时为USDT地址
realname	string	否	收款人真实姓名 type=1时为支付宝姓名 type=2时为微信姓名 type=3时为银行卡户名 type=4时不必填
bank_name	string	否	银行名称 type=3时为银行名称，其余时不建议显示及提交
bank_branch	string	否	开户支行 type=3时为开户支行，其余时不建议显示及提交
idcard_number	string	否	身份证号 type=4时不必填
collect_img	string	否	收款二维码图片URL
email_code	string	是	已绑定邮箱收到的 6 位提现地址验证码

响应示例：

{
  "code": 1,
  "msg": "保存成功"
}

错误响应示例：

{
  "code": 0,
  "msg": "xxx" //各种错误信息 如下
}

错误信息：

• 请先绑定有效邮箱
• 验证码已失效，请重新获取
• 邮箱验证码错误
• 资料填写不完整或存在非法字符！
• 保存失败，请重试！

---

4. 获取申请提现配置

接口地址： /merchantapi/wallet/cash/applyConfig

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "user": {
      "id": 1000,
      "money": 2179, // 商户余额 - ⭐此字段为当前商户面板上 提现才可操作的资金
      "freeze_money": 36,
      "user_money": 100, // 用户余额
      "cash_type": 1, // 商户当前设置的提现方式 1=自动提现 2=手动提现 3=定时提现 10分钟运行一次定时提现
      "auto_cash_money": 0 // 商户设置的自动提现金额
    },
    "limit_num": 2, // 商户今日剩余提现次数
    "cash_fee_type": 100, // 手续费类型 1=固定人民币 2=固定USDT 100=百分比
    "cash_fee": "10%", // 手续费值 当 cash_fee_type = 100 时，为百分比（如：10 表示10%，显示为"10%"）
    "auto_cash_fee": 15, // 自动提现手续费 
    "cash_limit_time": "0:00 ~ 23:00", // 提现时间限制
    "cash_min_money": 100, // 最低提现金额
    "auto_cash_money": 50 // 系统设置的自动提现金额阈值
  }
}

说明：

• money 为商户可提现的余额
• 手续费计算方式根据 cash_fee_type 决定：
  • 固定人民币（type=1）：人民币手续费 = cash_fee
  • 固定 USDT（type=2）：人民币手续费 = cash_fee × u_coin_rate，按申请时汇率折算，四舍五入保留 3 位小数
  • 百分比（type=100）：手续费 = 提现金额 × (cash_fee / 100)

5. 设置提现方式

接口地址： /merchantapi/wallet/cash/setUserCashType

请求方式： POST

请求参数：

参数名	类型	必填	说明
cash_type	int	是	提现方式：1=自动提现，2=手动提现，3=定时提现
auto_cash_money	float	条件	定时提现金额（cash_type=3时必填，不低于10元）

响应示例：

{
  "code": 1,
  "msg": "保存成功"
}

提现方式说明：

• 能提现的是余额 money字段，含义：平台可提现资金
• 自动提现：每笔订单完成后收益被冻结24小时，第二天定时任务解冻后，在由定时任务发起自动提现
• 手动提现：商户手动申请提现
• 定时提现：达到设定金额后自动提现（10分钟检查一次）

---

固定 USDT 手续费配置

后台结算配置的手动和自动提现均支持：1 固定人民币、2 固定 USDT、100 百分比。 cash_fee_unit 和 auto_cash_fee_unit 分别返回 CNY、USDT 或 %，自动模式另返回 auto_cash_fee_type。 u_coin_rate 表示 1 USDT 对应的人民币金额。固定 USDT 值直接返回数字，不带百分号。 例如配置 3 USDT、申请时汇率 7.2，人民币手续费为 21.600；提现 100 元预计到账 (100 - 21.600) / 7.2 = 10.89 USDT。 提现记录的 fee、actual_money 继续保存人民币金额；不改变已有记录或已有固定人民币配置。 手续费必须非负；百分比最多 100，固定值最多 5000。汇率无效时拒绝固定 USDT 提现；扣费后金额必须大于 0。 定额提现沿用手动手续费配置，每日自动提现使用自动手续费配置。