跳到主要内容

查询 Checkout

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

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

GET /v1/checkouts/{id}

查询会话的当前状态及资金异常,可用于轮询支付结果、页面恢复和 Webhook 回查。不返回付款明细。

Attributes​

属性位置类型必填说明
idpathstring是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"
}

业务错误码