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

# 概述

> 企业卡的对象模型总览：合作伙伴 → 公司 → 员工的三层结构、贯穿全部接口的核心对象与 ID 约定，以及各概念页的阅读路线。

## 📄 正文

下面几个概念决定了您如何为客户建模账户、资金与管控。本页给出对象全景与 ID 约定，随后每个概念页各讲透一条主线。

## 三层身份模型

您的业务以「合作伙伴 → 公司 → 员工」三层组织：合作伙伴是您（一次 API 对接）；公司是您的企业客户（KYB 开户、建资金池）；员工是最终持卡人（KYC 后发卡）。卡可以发给公司（须指定托管人）或员工。

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/corp-identity-model-light.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=bbcf185c29745ed69563135feb41787e" alt="合作伙伴、公司、员工与卡的对象关系" width="674" height="244" data-path="imgs/diagrams/corp-identity-model-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/corp-identity-model-dark.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=6a978c51751bc0d35b44ef4aa6aeb9f4" alt="合作伙伴、公司、员工与卡的对象关系" width="674" height="244" data-path="imgs/diagrams/corp-identity-model-dark.svg" />
</Frame>

## 核心对象与 ID 约定

契约中所有 ID 均为 JSON 字符串，形态与语义如下：

| 对象                | ID                                                                             | 形态                     | 说明                       |
| ----------------- | ------------------------------------------------------------------------------ | ---------------------- | ------------------------ |
| 公司                | `organizationId`                                                               | UUID 形态字符串             | KYB 通过后下发，后续所有接口用它       |
| 员工                | `customerId`                                                                   | UUID 形态字符串             | KYC 通过后下发                |
| 卡 / 申请 / 事件       | `cardId` / `organizationApplyId`、`customerApplyId`、`cardApplyId` / `webhookId` | 19 位雪花数字串              | **必须作字符串传输**，数字字面量会被静默截断 |
| 规则 / 划拨 / 账单 / 交易 | `ruleId` / `transferId` / `statementId` / `transactionId`                      | 业务字符串                  | 原样透传                     |
| 合作伙伴侧 ID          | `externalXxx`                                                                  | `^[A-Za-z0-9_-]+$`，≤64 | 由您生成并持久化，同时充当幂等键         |

多态 ID（`subjectId` / `subjectId` / `subjectId`）的语义由同一结构中的类型字段决定，不可由取值形态推断。

## 两条正交轴

「卡发给谁」（持卡主体 holder）与「钱从哪个账户出」（资金主体 owner）是两条独立的轴，对应关系由卡型 `cardProfileId` 带出——这是理解卡型与资金接口的钥匙，详见[持卡主体与资金模型](./identity-and-funding)。

## 阅读路线

| 概念页                                 | 回答的问题                            |
| ----------------------------------- | -------------------------------- |
| [持卡主体与资金模型](./identity-and-funding) | 卡发给谁、钱从哪出、两种资金模式怎么选              |
| [状态机与冻结体系](./states-and-freezing)   | 申请 / 公司 / 员工 / 卡各自的状态如何流转、冻结怎么生效 |
| [交易生命周期](./transaction-lifecycle)   | 一笔消费从授权占用到入账的全过程                 |
| [合规与 KYC](./compliance-kyb-kyc)     | KYB / KYC 审什么、被拒怎么办、哪些信息全局唯一     |
| [限额与账单](./limits-and-billing)       | 消费管控怎么表达、账单以什么为最终口径              |

## 下一步

* 从对象模型进入第一条主线：[持卡主体与资金模型](./identity-and-funding)
* 直接动手跑通第一张卡：[快速开始](../getting-started/quickstart)