资金流水
分页返回当前账号的账户资金逐笔流水,用于与自身系统逐笔对账。每笔流水含流水号、类型、金额、关联订单号与时间。
请求接口
请求头部(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 标准时间)