跳到主要内容

列出归集项

商户路由已确认。 查看适用范围。

对象与完整字段 · 认证、金额与错误 · 接入指南

GET /v1/settlement-items

查询当前商户的归集项,默认返回可归集项。按平台首次确认入款可归集的时间倒序排列,时间相同时按 ID 倒序排列。多个筛选条件同时生效。

Attributes​

属性位置类型必填说明
statusquerystring否available、in_progress、settled;默认 available
chainqueryinteger否按网络编号筛选
currencyquerystring否按稳定币筛选:usdc、usdt
page_sizequeryinteger否每页数量,默认 20,范围 1–100
page_tokenquerystring否上一页返回的 next_page_token;第一页不传

无需 Idempotency-Key,无请求体。翻页时保持筛选条件不变。列表反映查询时的状态,创建归集时仍会重新校验所选项。

请求示例​

GET /v1/settlement-items?status=settled&chain=8453&currency=usdc&page_size=20
Authorization: Bearer inv_test_...

返回示例​

200 OK,返回完整的 SettlementItem 对象数组。

{
"data": [
{
"id": "si_example",
"status": "settled",
"amount": "12.5",
"currency": "usdc",
"chain": 8453,
"recipient_address": "0x1234567890abcdef1234567890abcdef12345678",
"settlement_id": "st_example",
"settled_at": "2026-10-27T08:10:00Z"
}
],
"next_page_token": ""
}

没有匹配记录时返回 {"data":[],"next_page_token":""}。

业务错误码