資金流水
分頁返回當前賬戶的賬戶資金逐筆流水,用於與自身系統逐筆對賬。每筆流水含流水號、類型、金額、關聯訂單號與時間。
請求接口
請求頭部(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 標準時間)