公司管理 · 概述 - DCS Technical Documentation

📄 正文

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

谁做什么

步骤	谁做	说明
提交开户申请	合作伙伴	收集公司资料，调 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，代表已受理。

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

第二步：拿开户结果

以 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，语义见状态机与冻结体系）。 冻结 / 解冻：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 通知。

{
  "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。信封结构与验签见快速开始。

下一步

公司 ACTIVE 后创建持卡人：管理员工
给资金池充值：资金与对账
本组详页：公司开户与审核 · 公司状态与预警

​📄 正文

​谁做什么

​第一步：提交开户

​第二步：拿开户结果

​日常维护

​关联 Webhook

​下一步

📄 正文

谁做什么

第一步：提交开户

第二步：拿开户结果

日常维护

关联 Webhook

下一步