查询结算账单
请求接口
openapi/v2/settlement/pageSettlements
公共参数
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| start_time | 是 | String(32) | 结算开始时间，格式为yyyy-MM-dd HH:mm:ss |
| end_time | 是 | String(32) | 结算结束时间，格式为yyyy-MM-dd HH:mm:ss |
| page_num | 否 | Integer | 当前页码，最小值为1，默认为1 |
| page_size | 否 | Integer | 每页数据条数，取值为1-1000，默认为10 |
响应参数
| 参数 | 必填 | 类型 | 描述 |
|---|---|---|---|
| total | 是 | Long | 数据总条数 |
| has_next_page | 是 | boolean | 是否有下一页 |
| page_num | 是 | Integer | 当前页码 |
| page_size | 是 | Integer | 每页数据条数 |
| list | 否 | Array | 当前页的数据列表 |
list结构说明：
| 参数 | 必填 | 类型 | 描述 |
|---|---|---|---|
| settlement_no | 是 | String(64) | 结算单号 |
| mch_id | 是 | String(32) | 商户id |
| account_no | 是 | String(64) | 支付账户编号 |
| start_time | 是 | String(32) | 开始时间 |
| end_time | 是 | String(32) | 结束时间 |
| order_fee | 否 | Long | 订单金额 |
| received_fee | 否 | Long | 实收金额 |
| refund_actual_fee | 否 | Long | 实退金额 |
| summary_fee | 否 | Long | 汇总金额：实收金额-实退金额 |
| service_fee | 否 | Long | 手续费：实收手续费-退款费用返还 |
| preview_fee | 否 | Long | 预览结算金额 |
| settlement_fee | 否 | Long | 结算金额 |
| receiver_info | 否 | Json | 收款人信息 |
| status | 否 | String(32) | 结算状态 |
| reason | 否 | String(128) | 失败原因 |
| remark | 否 | String(128) | 结算说明 |
| create_time | 否 | String(32) | 创建时间 |
| remit_time | 否 | String(32) | 打款时间 |
| remit_details | 否 | JsonArray | 打款明细 |
receiver_info结构说明：
| 参数 | 必填 | 类型 | 描述 |
|---|---|---|---|
| receiver_account_no | 否 | String(32) | 收款人账号 |
| receiver_account_name | 否 | String(32) | 收款人名称 |
remit_details结构说明
| 参数 | 必填 | 类型 | 描述 |
|---|---|---|---|
| settlement_no | 否 | String(64) | 结算单号 |
| remit_no | 否 | String(64) | 打款单号 |
| fund_no | 否 | String(64) | 提现单号 |
| remit_fee | 否 | Long | 打款金额 |
| service_fee | 否 | Long | 手续费 |
| remit_actual_fee | 否 | Long | 实际打款金额 |
| type | 否 | Integer | 打款类型，0：自动打款，1：手动打款 |
| status | 否 | String(64) | 打款状态 |
| remit_succ_time | 否 | String(32) | 打款完成时间 |
| remark | 否 | String(128) | 备注 |
| settle_account_type | 否 | String(64) | 结算账户类型，BANKCARD：结算至银行卡账户，ACCOUNT：结算至资金账户 |
| channel_remit_no | 否 | String(64) | 打款单号（渠道侧） |
打款状态 status
| 打款状态 | 说明 |
|---|---|
| PENDING | 待入账 |
| RECONCILIATION | 对账中 |
| REMIT_ING | 打款中 |
| REMIT_SUCCESS | 打款成功 |
| REMIT_FAIL | 打款失败 |
| SETTLEMENT_FAIL | 结算失败 |
| SETTLEMENT_ALREADY | 应结另结 |
::: tip 提示
- 所有金额单位均为分