列出 Checkout
商户路由已确认。 查看适用范围。
GET /v1/checkouts
查询当前商户的会话列表,按创建时间倒序排列,创建时间相同时按 ID 倒序排列。多个筛选条件同时生效。
Attributes
| 属性 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
order_id | query | string | 否 | 商户订单号,精确匹配,可返回多个 Checkout |
status | query | string | 否 | open、processing、succeeded、failed |
has_exception | query | boolean | 否 | true 仅返回有资金异常的会话,false 仅返回无异常的会话;不传则不限 |
created_from | query | string | 否 | 创建时间起点,包含 |
created_to | query | string | 否 | 创建时间终点,不包含 |
page_size | query | integer | 否 | 每页数量,默认 20,范围 1–100 |
page_token | query | string | 否 | 上一页返回的 next_page_token;第一页不传 |
请求示例
GET /v1/checkouts?order_id=ORDER_001&status=succeeded&page_size=20
Authorization: Bearer inv_test_...
返回示例
200 OK,data 中每项均为完整的 Checkout 对象,不附带付款明细。
{
"data": [
{
"id": "checkout_example",
"amount": "10",
"currency": "usdc",
"transaction_speed": "low",
"status": "succeeded",
"failure_reason": null,
"exception_status": null,
"order_id": "ORDER_001",
"description": "Order payment",
"metadata": {},
"url": "https://pay.example.com/c/checkout_example",
"return_url": "https://merchant.example.com/orders/ORDER_001",
"expires_at": "2026-10-28T08:30:00Z",
"created_at": "2026-10-28T08:00:00Z",
"updated_at": "2026-10-28T08:02:00Z"
}
],
"next_page_token": ""
}