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

# 状态机与冻结体系

> 四套状态一次讲清：公司/员工/卡共用的申请状态机、公司与员工的合并状态视图、卡的 7 状态机，以及 5 个冻结能力域的集合语义。

## 📄 正文

开户、建员工、发卡，每类对象都有自己的状态机；冻结则是叠加在状态之上的能力域开关。本页把它们一次讲清，后续接口里的状态字段即可对号入座。

## 申请状态机

公司、员工、卡三类申请共用一套状态机，三个状态：`PENDING` / `SUCCEED` / `REJECTED`。被拒后可按同一申请单 ID 重提（详见[合规与 KYC](./compliance-kyb-kyc)）。

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/dcs-0bf7a937/_4q96txtGLVP3b4d/imgs/diagrams/corp-apply-states-light.svg?fit=max&auto=format&n=_4q96txtGLVP3b4d&q=85&s=bbc5b667ec06255156f059615ac9b68c" alt="申请状态机" width="520" height="254" data-path="imgs/diagrams/corp-apply-states-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/dcs-0bf7a937/_4q96txtGLVP3b4d/imgs/diagrams/corp-apply-states-dark.svg?fit=max&auto=format&n=_4q96txtGLVP3b4d&q=85&s=a8f6ec0ad3ed32241e4897b686268005" alt="申请状态机" width="520" height="254" data-path="imgs/diagrams/corp-apply-states-dark.svg" />
</Frame>

## 公司 / 员工状态机

呈现为一个合并状态字段：生命周期（`ACTIVE` / `TERMINATED`）叠加行为状态（`FROZEN` / `SUSPENDED` / `RESTRICTED`）。判断能否开卡 / 消费以是否 `ACTIVE` 为准。

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/corp-entity-states-light.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=79560d61f9cdfbd4cd64744087ceecb4" alt="公司 / 员工状态机" width="762" height="218" data-path="imgs/diagrams/corp-entity-states-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/corp-entity-states-dark.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=b11cb666a0aefd029de3c12a6e3598e0" alt="公司 / 员工状态机" width="762" height="218" data-path="imgs/diagrams/corp-entity-states-dark.svg" />
</Frame>

## 卡状态机

7 个状态，虚拟卡与实体卡采用同一套状态定义。每次状态变更系统都会推送卡状态变更通知（激活单独推送 `CARD_ACTIVATED`），事件名以 API 参考的 Webhook 事件表为准。

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/corp-card-states-light.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=9228317fdc4202d4f7608cc0c7789f05" alt="卡状态机" width="641" height="444" data-path="imgs/diagrams/corp-card-states-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/corp-card-states-dark.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=ddc1890c80b9def50e3f128f0a636461" alt="卡状态机" width="641" height="444" data-path="imgs/diagrams/corp-card-states-dark.svg" />
</Frame>

## 冻结能力域

5 个能力域，适用于公司或员工。加状态即冻结、删状态即解冻，幂等集合语义；风控 / 监管 / 司法写入的受限态不可经此解除。

| 能力域码              | 冻结后停用的范围                       |
| ----------------- | ------------------------------ |
| `ACCOUNT_FROZEN`  | 账户整体（登录、改密、改手机 / 邮箱、绑定 MFA、销户） |
| `CASH_IN_FROZEN`  | 入金 / 充值                        |
| `CASH_OUT_FROZEN` | 出金 / 提现 / 汇款                   |
| `PAYMENT_FROZEN`  | 支付 / 消费（含卡支付）                  |
| `CARD_FROZEN`     | 卡管理动作（申卡、激活、改 PIN）             |

冻结的粒度有两级：冻结卡只停该卡，冻结员工则该主体名下所有卡拒绝交易。操作接口见[公司状态与预警](../how-to-use/company-maintenance)与[员工信息与状态](../how-to-use/employee-maintenance)。

## 下一步

* 一笔交易从授权占用到入账的完整过程：[交易生命周期](./transaction-lifecycle)
* KYB / KYC 的对象、被拒重提与唯一性规则：[合规与 KYC](./compliance-kyb-kyc)