logan

Appearance

1. 获取提现统计 ​

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

响应示例：

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

字段说明：

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

2. 获取收款设置 ​

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

响应示例：

json
{
  "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. 设置提现地址 ​

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

请求方式： POST

请求参数：

参数名类型必填说明
typeint是收款方式类型 1=支付宝 2=微信 3=银行卡 4=USDT
accountstring是收款账号 type=1时为支付宝账号 type=2时为微信账号 type=3时为银行卡号 type=4时为USDT地址
realnamestring否收款人真实姓名 type=1时为支付宝姓名 type=2时为微信姓名 type=3时为银行卡户名 type=4时不必填
bank_namestring否银行名称 type=3时为银行名称，其余时不建议显示及提交
bank_branchstring否开户支行 type=3时为开户支行，其余时不建议显示及提交
idcard_numberstring否身份证号 type=4时不必填
collect_imgstring否收款二维码图片URL
cash_pwdstring是二级密码

响应示例：

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

错误响应示例：

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

错误信息：

  • 您还未设置二级密码，无法设置收款信息
  • 二级密码错误
  • 资料填写不完整或存在非法字符！
  • 保存失败，请重试！

4. 获取申请提现配置 ​

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

响应示例：

json
{
  "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=固定金额 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（固定值）
    • 百分比（type=100）：手续费 = 提现金额 × (cash_fee / 100)

5. 设置提现方式 ​

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

请求方式： POST

请求参数：

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

响应示例：

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

提现方式说明：

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