# 提现汇总查询
商户通过该接口查询V2结算体系下的提现历史记录,支持按状态和日期筛选。
# 接口信息
接口
请求API: /api/v2/recon/withdraw-summary
请求方式: GET
# 请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 状态 | state | 否 | int | 0 | 0-申请中,30-已发放,40-已拒绝,50-已取消 |
| 开始日期 | dateStart | 否 | String(10) | 2026-06-01 | 开始日期,格式yyyy-MM-dd |
| 结束日期 | dateEnd | 否 | String(10) | 2026-06-22 | 结束日期,格式yyyy-MM-dd |
| 页码 | pageNum | 否 | int | 1 | 默认1 |
| 每页条数 | pageSize | 否 | int | 20 | 默认20 |
# 返回参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 记录列表 | records | 是 | List | 提现记录列表 | |
| 总记录数 | total | 是 | long | 100 | |
| 当前页码 | current | 是 | long | 1 | |
| 是否有下一页 | hasNext | 是 | boolean | true |
# records 数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 提现ID | logId | 是 | long | 100001 | 调用 withdraw-detail 传入此 logId 查询详情 |
| 币种 | currency | 是 | String | USD | 币种 |
| 金额 | amount | 是 | long | 80000 | 提现金额,单位:微单位(1,000,000 = $1.00 USD) |
| 状态 | state | 是 | int | 0 | 0-申请中,30-已发放,40-已拒绝,50-已取消 |
| 状态名称 | stateName | 是 | String | 申请中 | 状态中文描述 |
| 备注 | remark | 否 | String | 备注 | |
| 创建时间 | createdAt | 是 | String | 2026-06-22 10:00:00 | 创建时间 |
# 返回示例
{
"code": 0,
"msg": "SUCCESS",
"data": {
"records": [
{
"logId": 100001,
"currency": "USD",
"amount": 80000,
"state": 0,
"stateName": "申请中",
"remark": "",
"createdAt": "2026-06-22 10:00:00"
}
],
"total": 1,
"current": 1,
"hasNext": false
}
}