> For the complete documentation index, see [llms.txt](https://docs.catfee.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catfee.io/api-reference/order-detail.md).

# 订单详情

支持通过平台订单 ID 或创建订单时传入的客户端订单 ID 查询订单。

### 根据订单 ID 查询

{% openapi src="/files/X0GExwrGaywXyFiL8Yfs" path="/v1/order/{id}" method="get" %}
[api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-020f0d7cb781685b28fc579c285b1dcd22b01755%2Fapi.json?alt=media)
{% endopenapi %}

### 根据客户端订单 ID 查询

使用创建订单时传入的 `client_order_id` 查询订单，无需提供平台返回的订单 `id`。

{% openapi src="/files/X0GExwrGaywXyFiL8Yfs" path="/v1/order" method="get" %}
[api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-020f0d7cb781685b28fc579c285b1dcd22b01755%2Fapi.json?alt=media)
{% endopenapi %}

### 时长租赁订单状态

以下规则适用于 Rental Open API 的 `POST /v1/order`（含幂等返回）、`GET /v1/order/{id}`、`GET /v1/order?client_order_id=...` 和 `POST /v1/reclaim/{id}` 返回的订单。其他业务接口的状态以各自文档为准。

`code=0` 表示本次接口调用成功，不代表代理已完成。请结合 `status` 和 `confirm_status` 判断订单进度。

| 字段及取值                                 | 含义                                                  |
| ------------------------------------- | --------------------------------------------------- |
| `status=PAYMENT_SUCCESS`              | 正常状态，订单等待代理或代理处理中，尚未表示代理完成。                         |
| `status=DELEGATE_SUCCESS`             | 代理交易已提交；是否已在链上确认，应检查 `confirm_status`。进入回收阶段后仍返回此值。 |
| `status` 为其他值                         | 均按失败处理。                                             |
| `confirm_status=UNCONFIRMED`          | 代理尚未确认。                                             |
| `confirm_status=DELEGATION_CONFIRMED` | 代理已在链上确认；进入回收确认阶段后仍返回此值。                            |
| `confirm_status` 为其他值                 | 均按失败处理。                                             |

`status` 的正常值仅为 `PAYMENT_SUCCESS` 和 `DELEGATE_SUCCESS`；`confirm_status` 的正常值仅为 `UNCONFIRMED` 和 `DELEGATION_CONFIRMED`。任一字段为其他值时，均按失败处理。

回收是平台内部流程，上述接口不会通过这两个字段暴露回收状态：

| 内部状态                                                                                   | API 返回值                               |
| -------------------------------------------------------------------------------------- | ------------------------------------- |
| `status` 为 `RECLAIM_SUCCESS`、`RECLAIMING` 或 `RECLAIM_FAIL`                             | `status=DELEGATE_SUCCESS`             |
| `confirm_status` 为 `RECLAIM_CONFIRMED`、`RECLAIM_CONFIRMING` 或 `RECLAIM_CONFIRMED_FAIL` | `confirm_status=DELEGATION_CONFIRMED` |

两个字段分别转换，其他状态保持原值。申请回收成功不表示链上回收已经完成，也不应等待这两个字段变成回收状态。

`DELEGATION_CONFIRMED` 表示该订单的代理曾经成功交付，不保证查询时仍有可用能量。订单到期或提前回收后，状态仍可保持成功；请结合 `expired_timestamp`、回收信息及接收地址的链上资源情况判断当前是否可用。

### 用户余额

上述接口返回的订单对象包含 `balance` 字段，表示用户当前余额，类型为整数，单位为 **SUN**（1 TRX = 1,000,000 SUN）。该字段不是订单金额，也不是订单支付时保存的历史余额。