2.6 Get Deposit And Withdraw Transaction By Time (Common)
供 Merchant 按日期 和时间 范围获取代理所有直属 member 的存取款记录。结果与 2.3 Get Deposit And Withdraw Transaction 相同,区别是 startDate / endDate 可以带时间,并可选择时区。
Method : [Post]
Path : {{domain}}/ext/depositWithdrawTransactionHistoryByTime/{{prefix}}/{{agentUsername}}
Content-Type : application/json
Request Body
{
"agentUsername": "{{agentUsername}}",
"key": "{{key}}",
"startDate": "01-11-2026 09:00:00",
"endDate": "01-11-2026 18:29:59",
"gmt": "+07:00",
"web": "{{whiteLabel}}"
}
| Key | Type | Example Value | Description |
|---|---|---|---|
| agentUsername | String | testag | 代理账号 |
| key | String | tnyENKDWvOkBXpvm6UZVa | 代理密钥 |
| startDate | String | 01-11-2026 09:00:00 | 开始时间 DD-MM-YYYY HH:mm:ss,包含 |
| endDate | String | 01-11-2026 18:29:59 | 结束时间 DD-MM-YYYY HH:mm:ss,包含到该秒结束 |
| gmt | String | +07:00 | 可选。startDate / endDate 的时区,格式 +HH:MM 或 -HH:MM(分钟为 00、15、30 或 45,范围 -12:00 至 +14:00)。不传 = GMT+7 |
| web | String | sportbook101 | 使用的网站 |
时间范围规则
- 格式必须完全一致:日、月、时、分、秒均为两位数,例如
01-11-2026 09:05:00。只传日期不带时间会返回 50013。 - 两端都包含,且
endDate计算到该秒结束。01-11-2026 00:00:00→01-11-2026 23:59:59即整天,与 2.3 传01-11-2026→02-11-2026返回相同记录。连续分段查询时,结束时间比下一段开始早一秒:00:00:00–00:59:59、01:00:00–01:59:59。 startDate可以等于endDate(一秒),但不能晚于endDate(50014)。- 同一时刻用不同时区传入,结果相同:
01-11-2026 07:00:00配+07:00=01-11-2026 00:00:00配+00:00。 - 记录的
date是实际记录时间,因此时间范围精确到秒。 - 只返回代理直属 member 且
transaction: "success"的记录,不保证顺序。
Response
{
"code": 0,
"data": [
{
"_id": "62b974f56e82c478362086bb",
"transaction": "success",
"user": "auto0859765751",
"actionBy": "API",
"currency": "THB",
"action": "DEPOSIT",
"amount": 10,
"withdraw": 0,
"from": "CASH",
"date": "2026-11-01T02:14:29.256Z",
"__v": 0,
"afterCredit": 10,
"beforeCredit": 0
}
]
}
| Key | Type | Description |
|---|---|---|
| code | Number | API 返回码 |
| data | Array | 存取款记录,字段与 2.3 相同。无记录时为空数组 |
| data[].user | String | member 账号 |
| data[].action | String | DEPOSIT 或 WITHDRAW |
| data[].amount | Number | 金额 |
| data[].currency | String | 币种 |
| data[].beforeCredit / afterCredit | Number | 操作前后余额 |
| data[].date | Date | 记录时间(UTC) |
Error Code
| Value | msg |
|---|---|
| 0 | Success |
| 100001 | Missing 'agent Username' field. |
| 100002 | Agent username is type string. |
| 100003 | Missing 'key' field. |
| 100004 | Key is type string. |
| 100012 | Key not found. |
| 100013 | Agent not found. |
| 104 | missing 'startDate' field |
| 105 | missing 'endDate' field |
| 50012 | Invalid 'gmt' field. Expected format '+07:00'. |
| 50013 | Invalid 'startDate' or 'endDate'. Expected format 'DD-MM-YYYY HH:mm:ss'. |
| 50014 | 'startDate' must not be after 'endDate'. |
| 50010 | Something went wrong please try again.(临时错误,请重试) |