Skip to main content

📄 正文

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

三层身份模型

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

核心对象与 ID 约定

契约中所有 ID 均为 JSON 字符串,形态与语义如下: 多态 ID(subjectId / subjectId / subjectId)的语义由同一结构中的类型字段决定,不可由取值形态推断。

两条正交轴

「卡发给谁」(持卡主体 holder)与「钱从哪个账户出」(资金主体 owner)是两条独立的轴,对应关系由卡型 cardProfileId 带出——这是理解卡型与资金接口的钥匙,详见持卡主体与资金模型

阅读路线

下一步