> ## 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.

# 公司管理 · 概述

> 为企业客户开户并维护公司：提交 KYB 开户、查询与重提、冻结解冻、余额不足预警，含关键参数与幂等/去重规则。

## 📄 正文

公司是您的企业客户在平台上的资金与合规主体：开户即建立资金池，此后的员工、卡、余额都挂在它名下。本页按「开户 → 拿结果 → 日常维护」的顺序讲清每一步调用什么、传什么、拿什么。

## 谁做什么

| 步骤        | 谁做   | 说明                                    |
| --------- | ---- | ------------------------------------- |
| 提交开户申请    | 合作伙伴 | 收集公司资料，调 apply 提交                     |
| KYB 尽职调查  | DCS  | 异步审核，结果经 Webhook 推送                   |
| 处理结果 / 重提 | 合作伙伴 | 通过后落库 `organizationId`；被拒修正后 resubmit |
| 日常维护      | 合作伙伴 | 冻结 / 解冻、余额预警配置                        |

## 第一步：提交开户

`POST /open-api-corp/organization/v1/apply`——提交申请后异步进行企业尽职调查（KYB），受理即返回 `organizationApplyId`。

| 字段                          | 必填 | 说明                                                              |
| --------------------------- | -- | --------------------------------------------------------------- |
| `organizationRef`           | 是  | ≤64；合作伙伴侧公司唯一标识（幂等键），字符集 `^[A-Za-z0-9_-]+$`                     |
| `organizationName`          | 是  | ≤256；公司法定名称，仅允许英文、数字、空格                                         |
| `companyRegistrationNumber` | 是  | ≤64；公司注册号                                                       |
| `email`                     | 是  | ≤128；公司联系邮箱                                                     |
| `fundingCurrencies`         | 是  | 资金池币种（USD / HKD，可多个，各币种各建一个收款虚拟账号 VA）；不可重复、须为本企业允许币种的子集，超范围整单拒绝 |

同步响应只有 `organizationApplyId` + `status=PENDING`，代表已受理。

<Warning>
  **去重按三个维度判定**：`organizationRef`、`email`、`companyRegistrationNumber` 在合作伙伴维度唯一，后两者**即使被拒也不释放**。同一 `organizationRef` 已有在途/已成功申请再提返回 `APPLY_DUPLICATE`；仅存在被拒申请时返回 `APPLY_REJECTED_USE_RESUBMIT`——正确路径是 resubmit，不要换 ID 重发。
</Warning>

## 第二步：拿开户结果

以 Webhook `ORGANIZATION_CREATED` / `ORGANIZATION_REJECTED` 为主，`GET /open-api-corp/organization/v1/query-apply?organizationApplyId=...` 轮询兜底。响应关键字段：

| 字段                         | 说明                                                      |
| -------------------------- | ------------------------------------------------------- |
| `status`                   | `PENDING`（KYB 处理中）/ `SUCCEED`（开户成功）/ `REJECTED`（KYB 拒绝） |
| `status` / `rejectMessage` | 申请状态与拒绝原因（`REJECTED` 时才有 `rejectMessage`）               |
| `organizationId`           | 公司 ID，`SUCCEED` 后才有——请落库，后续所有接口都用它                      |

**被拒后重提**：`POST /open-api-corp/organization/v1/resubmit`，传 `organizationApplyId` + 修正后的 `organizationName` / `companyRegistrationNumber`，沿用同一申请重新送审；`organizationRef` 不可变更。仅当前状态为 `REJECTED` 时允许，否则返回 `STATUS_CONFLICT`。

## 日常维护

**查询公司详情**：`GET /open-api-corp/organization/v1/query?organizationId=...`，返回法定名称、注册号、资金池币种列表与状态（生命周期 `ACTIVE` / `TERMINATED`，叠加行为状态 `FROZEN` / `SUSPENDED` / `RESTRICTED`，语义见[状态机与冻结体系](../basic-concepts/states-and-freezing)）。

**冻结 / 解冻**：`POST /open-api-corp/organization/v1/update-restrictions`，幂等集合语义——`addRestrictions` 加状态即冻结、`removeRestrictions` 删状态即解冻，取值仅限 5 个能力域码：`ACCOUNT_FROZEN` / `CASH_IN_FROZEN` / `CASH_OUT_FROZEN` / `PAYMENT_FROZEN` / `CARD_FROZEN`（传其他值返回 `DAPI_PARAM_INVALID`）。状态变更推送 Webhook 通知。

```json theme={null}
{
  "organizationId": "e7c9a1f0-3b52-4d8e-9a67-1f2b3c4d5e6f",
  "addRestrictions": ["PAYMENT_FROZEN", "CARD_FROZEN"],
  "remark": "suspicious transactions under review"
}
```

**余额不足预警**：`POST /open-api-corp/fund/v1/balance-alert-set`，按币种设阈值（`balanceSettings[].currency` + `balanceSettings[].thresholdAmount`），可选 `emailSettings`。**整份替换语义**——每次提交重设全部预警配置；默认发 Webhook `LOW_BALANCE`，配了邮箱才额外发邮件；同一预警一天发送一次，直至余额回补。

## 关联 Webhook

`ORGANIZATION_CREATED`（KYB 通过，携 `organizationId`）/ `ORGANIZATION_REJECTED`(携 `rejectMessage`)/ 公司状态变更通知（携 `addRestrictions` / `removeRestrictions`）/ `LOW_BALANCE`。信封结构与验签见[快速开始](../getting-started/quickstart)。

## 下一步

* 公司 ACTIVE 后创建持卡人：[管理员工](./managing-employees)
* 给资金池充值：[资金与对账](./funding-and-reconciliation)
* 本组详页：[公司开户与审核](./company-onboarding) · [公司状态与预警](./company-maintenance)