> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 订单状态

> fiat_to_crypto、crypto_to_fiat 和 fiat_to_fiat 订单中每个 orderStatus 值的含义，以及哪些状态表示订单终结。

`GET /v2/order/detail` 和 `GET /v2/orders` 通过整数字段 `orderStatus` 返回订单状态。出入金订单（`fiat_to_crypto` 和 `crypto_to_fiat`）与全球支付订单（`fiat_to_fiat`）使用两套不同的状态码。

> [!WARNING]
>
> 请始终将 `orderStatus` 与 `orderType` 结合解读。部分状态码在两套体系中含义不同：`71` 对出入金订单表示“取消中”，对全球支付订单则表示“收款已取消”；`72` 对出入金订单表示“已退款”，对全球支付订单则表示“付款已取消”。

## 出入金订单（fiat\_to\_crypto、crypto\_to\_fiat）

| 状态码 | 名称 | 含义 | 是否终结订单 |
| - | - | - | - |
| `10` | 审核中 | 订单正在审核中。 | 否 |
| `11` | 风控审核 | 订单正在进行风控审核。您可以通过[上传文件](https://docs.velafi.com/cn/api-reference/order/upload-invoice-documents-for-a-specific-order.md)上传证明材料，订单随后进入 `12`。 | 否 |
| `12` | RFI 材料已上传 | 风控审核期间已上传材料，正在等待决定。如果风控审核拒绝该订单，订单将进入 `81`（或先进入 `71`，见下文）。 | 否 |
| `31` | 待补充证明材料 | 需要提供证明材料。通过[上传文件](https://docs.velafi.com/cn/api-reference/order/upload-invoice-documents-for-a-specific-order.md)上传后，订单进入 `40`。 | 否 |
| `32` | 等待加密货币充值 | 仅适用于 `crypto_to_fiat`。尽管您的加密货币余额不足以覆盖订单，订单仍被接受（后付款出金）。`GET /v2/order/detail` 仅在此状态下返回 `orderExpireTimestamp`。只有在 `orderExpireTimestamp` 之前您的余额足以覆盖订单时，订单才能进入 `40`（如需材料则进入 `31`）。 | 否 |
| `40` | 待付款 | `fiat_to_crypto`：等待法币付款。`crypto_to_fiat`：加密货币已从您的余额中扣除，法币付款待处理。 | 否 |
| `50` | 已付款 | 付款步骤已完成，但订单尚未完成。对于 `crypto_to_fiat`，您可以通过[确认订单](https://docs.velafi.com/cn/api-reference/order/confirm-a-specific-order.md)完成订单。如果您不确认，使用自动付款通道的订单会在付款成功一段时间后自动完成。 | 否 |
| `60` | 已完成 | 订单已完成。已完成的订单仍可能被退款，例如其法币付款被退回时：订单将先进入 `73`（退款中）再进入 `72`，或直接进入 `72`。 | 是，除非之后被退款 |
| `70` | 已取消 | 订单已取消。未付款而过期的订单也返回 `70`。 | 是 |
| `71` | 取消中 | 订单正在被取消或拒绝，但 `crypto_to_fiat` 订单的加密货币退还失败。定时任务会完成该处理。 | 否 |
| `72` | 已退款 | 退款已完成。 | 是 |
| `73` | 退款中 | 退款正在进行中。 | 否 |
| `80` | 已拒绝 | 订单在审核中被拒绝。审核超时的订单也返回 `80`。 | 是 |
| `81` | 风控审核拒绝 | 订单在风控审核中被拒绝（来自 `11` 或 `12`）。 | 是 |

通过 API 创建的新订单通常以 `10`、`11`、`31`、`32`（仅 `crypto_to_fiat`）或 `40` 开始。对于 `crypto_to_fiat` 订单，如果创建订单时无法从您的余额中扣除加密货币，创建调用仍会返回 `orderId`，但查询时订单已处于 `70`（已取消）。

> [!NOTE]
>
> `GET /v2/orders` 会列出您账户下所请求 `orderType` 的所有订单，而不仅限于您通过 API 创建的订单。由 VelaFi 为您的账户创建的订单（而非通过 API 或控制台创建）还可能显示 `20`（审核被拒）或 `30`（已批准）。通过 API 创建的订单不会出现这两个状态码。获批后，它们通常从 `10` 进入 `31`、`32` 或 `40`；如果在批准时价格已低于 VelaFi 的最低汇率，则订单会被取消（`70`，或如上所述先进入 `71`）。审核拒绝会报告为 `80`（或如上所述先进入 `71`）。

### 内部状态的报告方式

VelaFi 存储的部分内部状态会由 API 以其他状态码报告。对于出入金订单，您永远不会收到 `0`、`90`、`91` 或 `92`：

| 内部状态 | 报告为 |
| - | - |
| `0`（初始化中） | `10` |
| `90`（审核超时） | `80` |
| `91`（未付款，已超时） | `70` |
| `92`（余额不足，已超时） | `70` |

## 全球支付订单（fiat\_to\_fiat）

| 状态码 | 名称 | 含义 | 是否终结订单 |
| - | - | - | - |
| `10` | 审核中 | 订单正在审核中。 | 否 |
| `11` | 风控审核 | 订单正在进行风控审核。您可以通过[上传文件](https://docs.velafi.com/cn/api-reference/order/upload-invoice-documents-for-a-specific-order.md)上传证明材料，订单随后进入 `12`。 | 否 |
| `12` | RFI 材料已上传 | 风控审核期间已上传材料，正在等待决定。 | 否 |
| `31` | 待补充证明材料 | 需要提供证明材料，且尚未上传任何材料。上传后，订单将重新显示为 `41` 或 `51`。 | 否 |
| `41` | 待收款 | 等待付款方的法币充值。 | 否 |
| `51` | 待付款 | 收款环节已完成，付款环节正在进行中。 | 否 |
| `60` | 已完成 | 付款环节已完成。 | 是 |
| `71` | 收款已取消 | 收款环节已取消。审核中被拒绝或审核超时的订单也返回 `71`。 | 是 |
| `72` | 付款已取消 | 付款环节已取消。 | 是 |
| `90` | 风控审核拒绝 | 订单在风控审核中被拒绝。 | 是 |

### 内部状态的报告方式

部分内部状态会以其他状态码报告：

| 内部状态 | 报告为 |
| - | - |
| `0`（初始化中） | `10` |
| `30`（已批准） | `41`；如需材料且缺失则为 `31` |
| `40`（已收款） | `51` |
| `41`、`51` | 不变；如需材料且缺失则为 `31` |
| `73`（审核超时） | `71` |
| `90`（审核被拒） | `71` |
| `91`（风控审核拒绝） | `90` |

## 按状态筛选

`GET /v2/orders` 支持 `orderStatus` 筛选条件。`0`（默认值）返回所有状态。

* \*\*出入金订单：\*\*可按出入金状态表中的任意状态码筛选。`10`、`70` 和 `80` 也会匹配以这些状态码报告的内部状态，因此结果与您看到的 `orderStatus` 一致。
* \*\*全球支付订单：\*\*筛选条件作用于存储的状态，而非报告的状态。`10`、`11`、`12`、`60` 和 `72` 精确匹配。`41` 和 `51` 也可能返回报告为 `31` 的订单。按 `31`、`71` 或 `90` 筛选时，返回的订单与以该状态码报告的订单并不完全一致。

## Webhook

Webhook 推送内容使用其自身的状态映射。例如，处于 `80` 或 `81` 的出入金订单会以 `70` 推送。推送的具体值请参阅各 Webhook 页面，例如[法币/加密货币订单推送](https://docs.velafi.com/cn/api-reference/webhooks/fiat-crypto-order-message-push.md)。


## Related topics

- [获取订单](https://docs.velafi.com/cn/api-reference/order/retrieve-a-specific-order.md)
- [订单事件](https://docs.velafi.com/cn/api-reference/webhooks/fiat-crypto-order-message-push.md)
- [入金（法币兑加密货币）](https://docs.velafi.com/cn/docs/guides/on-ramp.md)
- [全球支付（法币兑法币）](https://docs.velafi.com/cn/docs/guides/global-payments.md)
- [创建全球支付订单](https://docs.velafi.com/cn/api-reference/order/create-a-fiat-to-fiat-order.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.