logan

Appearance

1. 获取账户余额和今日收入 ​

接口地址： /merchantapi/wallet/operational/getTotalMoney

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "total_money": "1000.00", // 商户资金账户余额
    "today_income": "50.00", // 今日收益（不含推广收益）
    "promote_income": "10.00" // 今日推广收益
  }
}

2. 获取用户资金 ​

接口地址： /merchantapi/wallet/operational/getUserBalance

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "money": "1000.00", // 可提现余额
    "freeze_money": "500.00", // 冻结资金（待结算）
    "deposit_money": "200.00" // 运营钱包余额
  }
}

3. 获取充值通道 ​

接口地址： /merchantapi/wallet/operational/getRechargeChannel

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "fee_rate": 0.05, // 充值手续费率
    "channels": [
      {
        "value": 1, // 支付通道 ID
        "label": "支付宝", // 支付通道名称
        "ico": "https://fast.qqss.net/static/payment/zfb.png" // 支付通道图标
      }
    ]
  }
}

4. 运营钱包充值 ​

接口地址： /merchantapi/wallet/operational/doRecharge

请求方式： POST

请求参数：

参数名类型必填说明
amountfloat是充值金额
channelIdint是支付通道 ID

响应示例：

json
{
  "code": 1,
  "msg": "",
  "data": {
    "trade_no": "202312010001", // 充值订单号
    "url": "https://example.com/pay/202312010001" // 支付跳转页面URL
    "order_auto_close_time": 1800 // 订单自动超时关闭时间
  }
}

5. 充值订单列表 ​

接口地址： /merchantapi/wallet/operational/rechargeOrder

请求方式： POST

请求参数：

参数名类型必填说明
statusint否状态：0=待支付，1=已支付，2=已关闭，3=已退款
date_rangearray否日期范围
channel_idint否支付通道 ID
pageint否页码
limitint否每页数量

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 3,
        "trade_no": "M251119900059", // 充值订单号
        "user_type": 1, // 用户类型：1=商户
        "goods_name": "运营钱包充值 300元", // 商品名称
        "total_price": "315.000", // 订单总价
        "finally_money": "300.000", // 实际到账金额
        "user_id": 1000, // 用户ID
        "status": 1, // 状态：0=待支付，1=已支付，2=已关闭，3=已退款
        "channel_account_id": 1, // 支付通道账号ID
        "channel_id": 1, // 支付通道ID
        "recharge_type": "deposit_money", // 充值类型：deposit_money=运营钱包
        "fee": "15.000", // 手续费
        "create_at": "2025-11-19 15:55:28", // 创建时间
        "pay_at": 1763538936, // 支付时间
        "transaction_id": null // 第三方支付交易号
      }
    ],
    "total": 1
  }
}

6. 订单状态查询 ​

  • 此接口为接口方法，无需登录认证，直接访问即可

  • https://example.com/pay/{订单号} 亦可重新发起支付，支付完成后可能状态为 “订单已支付，请勿重复支付！”，“订单已超时关闭，请重新下单！”，“订单已退款！”

接口地址： /home/pay/orderStatus

请求方式： POST

权限要求： 无需登录认证

请求参数：

参数名类型必填说明
trade_nostring是充值订单号

响应示例：

json
{
  "code": 1,
  "msg": "订单已支付", // 订单已支付
  "data": {
    "status": 1 // 订单状态：1=已支付
  }
}
json
{
  "code": 0,
  "msg": "订单不存在",
  "data": "error"
}
json
{
  "code": 0,
  "msg": "订单超时已关闭",
  "data": {
    "status": 2 // 订单状态：2=已关闭
  }
}
json
{
  "code": 0,
  "msg": "订单已退款",
  "data": {
    "status": 3 // 订单状态：3=已退款
  }
}