查询 Checkout
商户路由已确认。 查看适用范围。
GET /v1/checkouts/{id}
查询会话的当前状态及资金异常,可用于轮询支付结果、页面恢复和 Webhook 回查。不返回付款明细。
Attributes
| 属性 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
id | path | string | 是 | Checkout 的唯一标识 |
请求示例
GET /v1/checkouts/checkout_example
Authorization: Bearer inv_test_...
返回示例
200 OK,返回完整的 Checkout 对象。
{
"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"
}