商户

结算记录

分页查询平台给你商户的结算记录,最新的排在最前面。

请求地址

https://z.weixiao.cc/settle,POST 表单。

请求参数

参数类型必填说明
pidString必填商户号,「API信息」里的商户号
limitInt否每次条数,默认 10,最大 50
offsetInt否跳过条数
signString必填签名
sign_typeString否签名类型
  • offset:从第几条之后开始返回,默认 0
  • sign:见「V1(MD5签名)」「V2(RSA签名)」
  • sign_type:MD5 或 RSA,不传按 MD5;签名方式为「RSA签名」的商户必须传 RSA

请求示例

curl -X POST 'https://z.weixiao.cc/settle' \
  --data-urlencode 'pid=1001' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'sign=你算出的签名' \
  --data-urlencode 'sign_type=MD5'

返回参数

参数类型说明
codeInt返回码,1 为成功
msgString返回信息
dataArray结算列表
  • data:本次返回的结算记录,没有记录时为空数组;不返回总数

结算字段

data 里每条记录都有下面这些字段,没有值的为 null。

参数类型说明
idInt结算编号(提现单号,19 位数字)
batchString批次号,人工结算时为 null
typeInt结算方式
accountString结算账户,收款的账号
usernameString收款人姓名
moneyString结算金额,单位元
realmoneyString实际到账,单位元
statusInt结算状态
transfer_noString打款流水号,线下打款时为空
addtimeString创建时间
endtimeString结算时间
  • type:1 支付宝,2 微信,4 银行卡,5 USDT
  • status:0 待结算,1 已结算,3 失败(驳回,金额退回余额)

返回示例

{
  "code": 1,
  "msg": "查询结算记录成功",
  "data": [
    {
      "id": 2026092700100012345,
      "batch": null,
      "type": 1,
      "account": "你的结算账户",
      "username": "收款人姓名",
      "money": "100.00",
      "realmoney": "99.40",
      "status": 1,
      "transfer_no": null,
      "addtime": "2026-09-27 00:10:00",
      "endtime": "2026-09-27 10:00:00"
    }
  ]
}

注意事项

  • 按结算记录生成的先后倒序返回,最新的在第一条。
  • limit 小于 1 时按 10 处理,大于 50 时按 50 处理。