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