资金流水
分页返回当前账号的账户资金逐笔流水,用于与自身系统逐笔对账。每笔流水含流水号、类型、金额、关联订单号与时间。
请求接口
请求头部(Headers)
| 字段名 | 字段值 | 操作 |
|---|---|---|
| + 添加字段 | ||
请求参数(Params)
| 字段名 | 字段值 | 操作 |
|---|---|---|
| + 添加字段 | ||
* token用于请求头部(Headers)或请求参数(Params)皆可
响应数据
{
"status": true,
"code": 0,
"msg": "获取成功",
"data": {
"page": 1,
"total": 2,
"totalPage": 1,
"results": [
{
"flowNo": "f992069588",
"flow": "payout",
"amount": -7.00,
"sn": "511907000",
"addtime": 20260210170728
},
{
"flowNo": "f992069589",
"flow": "refund",
"amount": 7.00,
"sn": "511907000",
"addtime": 20260211101200
}
]
}
}
请求字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| token | string |
访问信令,用于请求接口的身份验证 |
| flow | string |
流水类型(可选,不传返回全部可展示类型),值为: income - 充值 incomeRechargeVoucher - 充值券充值 payout - 消费(下单扣款,金额为负) refund - 退款(金额为正) |
| startTime | number |
起始时间(可选,YmdHis 整数,东八区 UTC+8 标准时间,按流水时间过滤,含边界) |
| endTime | number |
结束时间(可选,YmdHis 整数,东八区 UTC+8 标准时间,按流水时间过滤,含边界) |
| page | number |
页码(可选,默认1) |
| pageSize | number |
每页数量(可选,默认20,最大100) |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| status | boolean |
【请求状态】 true - 请求成功 false - 请求失败 |
| code | number |
【状态码】 0 - 获取成功 4003 - token无对应用户 4004 - 参数错误 4009 - 当前 ip 不在白名单内 4013 - 请求过于频繁,请稍后再试(每个会员默认 180 次/分钟) 40111 - 账号未完成认证,不允许调用API |
| msg | string |
【请求说明】 |
| data | object |
【请求数据】 page - 当前页码 total - 流水总条数 totalPage - 总页数 results - 流水列表(每个元素为一条资金流水) 【流水明细(results 每个元素包含以下字段)】 flowNo - 流水号(账户资金流水的唯一编号,字符串类型,用于逐笔对账) flow - 流水类型(见请求参数 flow) amount - 变动金额(USD;消费为负、退款/充值为正) sn - 关联的平台订单号(收入/充值券充值/消费/退款类均为对应订单 sn;无关联订单时为空字符串) addtime - 流水时间(YmdHis,东八区 UTC+8 标准时间) |