Get list of settlements
Payment Reports
Get list of settlements
查询结算列表,支持可选的筛选条件。
使用说明
- 如果同时省略
settled_start_time和settled_end_time,接口将返回默认时间窗口内的第一页结算记录:从今天往前一个月起至今天(含当天)。 - 指定日期范围时,必须同时提供
settled_start_time和settled_end_time。两者间隔不得超过一个月,且settled_end_time必须大于或等于settled_start_time。
GET
Get list of settlements
授权
UQPay 提供的登录 API Token。
请求头
指定代表哪个子账户发起该请求。应设置为 account_id,可通过 List Connected Accounts 获取。若省略或为空,则使用主账户执行请求。
更多信息见 Connected Accounts。
用于保持操作幂等性的唯一标识符(UUID),确保同一操作重复执行不会产生意外影响或重复结果。它有助于在网络错误、重试或故障时保持数据一致性。
查询参数
PaymentIntent 的唯一 ID。
示例:
"PI1945730395043532800"
结算批次的标识符。
示例:
"SB1947180993781698560"
用于按 settlement_date 筛选的起始日期(含),格式为 YYYY-MM-DD。时间基于 UTC+8。
示例:'2025-07-01' 表示 settlement_date ≥ 2025-07-01T00:00:00(UTC+8)。
示例:
"2025-07-01"
用于按 settlement_date 筛选的结束日期(含),格式为 YYYY-MM-DD。时间基于 UTC+8。
示例:'2025-07-31' 表示 settlement_date ≤ 2025-07-31T23:59:59(UTC+8)。
示例:
"2025-07-31"
用于获取下一批条目的页码,取值必须大于 1。
必填范围:
x >= 1示例:
1
每页返回的最大条目数,取值范围 1 - 100。
必填范围:
1 <= x <= 100示例:
10

