概览
registerBusiness 变更会在 Fluz 平台上创建一个企业账户。一次调用将：- 创建与申请人关联的企业账户——即你提交其令牌的 Fluz 用户，
- 存储法人实体记录——法定名称、组织结构、税号、注册州、法定地址、类别以及账户的预期用途，
- 存储你提供的每位所有者的实益所有权信息，
- 开启一个 KYB 案件用于合规审核，以及
- 将新企业账户链接到你的应用的 OAuth 授权。
accountId，其 kybStatus 为 SUBMITTED。
本页是该变更本身的参数与错误参考。关于前置条件、相关的调用顺序，以及如何跟踪案件直至决策，请先阅读 注册与验证企业。
必需的权限范围
使用企业账户令牌会在变更运行前被模式拒绝。不接受基本认证。
基本变更结构
参数
地址格式请使用下方给出的结构化字段来填写
businessLegalAddress 及每位所有者的 address，并确保为真实、可投递地址，且城市 / 州 / 邮编一致。两者均可为国际地址（国家名称为 ISO 3166；部分国家受限，如俄罗斯或伊朗）。企业法定地址会额外通过地址验证服务商核验，无法确认时将以 BS-0002 拒绝；所有者地址仅进行字段和州/省校验。参见地址格式要求。BusinessLegalAddress
存储的地址将是服务商标准化后的版本，其中
city、state、postalCode 会被转为大写——并非你提交的原始字符串。
RegisterBusinessConfirm
两字段均不可为 null，因此都需要发送。只有与名单匹配的那一项会被强制校验——该项设为
true，另一项设为 false。
BusinessOwner
OwnerAddress
BusinessStructure（枚举）
不在此列表中的结构将以
BS-0005 被拒绝。信托、非营利组织和其他实体类型将按个案处理——在针对这些类型进行开发前请联系你的客户经理。
BusinessAccountUsage（枚举）
请发送所有适用的值。若都不合适，省略
businessAccountUsage 并在 businessAccountUsageOther 中描述预期用途。发送枚举外的值会返回 BS-0004。
实益所有权要求
KYB 审核依赖于一次性准确提交所有权信息。请收集并提交：- 每一位直接或间接持有该实体 25% 或以上股份的个人。
- 一位控制人——对实体具有重大管理责任的个人（CEO、CFO、管理成员、普通合伙人等）——即便不持股。该所有者需设置
isControlPerson: true。名单中必须恰好一位带有该标记。 - 申请人——即你的 Bearer 令牌所属用户——通过
emailAddress或phoneNumber匹配。必须恰好一位所有者匹配，且该所有者不可为isInvited: true。
- 全体
ownershipPercentage的总和不得超过 100，但不必等于 100。若一家企业由三名个人分别持有 40/35/25，再加上一位不持股的 CEO，则提交四人，比例分别为 40、35、25 和 0。 - 若由实体（非自然人）持股，请穿透至其背后的自然人并提交这些个人。
- 所有者的邮箱与手机号在名单中必须唯一。
title为自由文本，但会由人工审核者阅读。请使用易识别的职衔（“Chief Executive Officer”、“Managing Member”），而非内部简称。
谁需要完整身份信息
每位所有者提交的详尽程度取决于其角色。每位所有者都需要基础字段；只有部分需要额外的身份信息。
基础字段：
firstName、lastName、title、ownershipPercentage、isControlPerson、isInvited、isUsPerson，以及 emailAddress / phoneNumber 至少一项。
完整身份信息：dob 和 address，当 isUsPerson 为 true 时还需 lastFourSsnDigits。当 isUsPerson 为 false 时省略 lastFourSsnDigits——该所有者会在注册后通过 requestOwnerDocumentVerificationLink 完成证件验证。
校验速查
大多数错误都源于格式问题。提交前请检查：文档材料
当申请人不是实益所有者或控制人时，需要提供授权签署人文件；在 KYB 审核过程中，任何组织结构都可能被要求提供额外文件。两类路径在同一页面覆盖：提交企业文件
上传端点、可接受文件以及当合规要求更多信息时应如何处理。
响应详情
RegisterBusinessError
校验与业务规则失败会在响应负载内部返回，而非作为顶层 GraphQL 错误。因此应根据
error 的存在（或 success === false）来分支，而不要依赖 HTTP 状态码。权限失败是例外：错误的 scope、错误的账户类型或使用基本认证会在解析器运行前被拒绝，并出现在顶层 errors 数组中，同时 data.registerBusiness 为 null。cURL 示例
响应示例
成功
错误
错误代码
在负载内返回，且success: false：
在顶层
errors 数组中返回，且 data.registerBusiness 为 null：
所有者名单问题会以
ARG-0001 报告，而非 BS-0003。BS-0003（InvalidOwnerInformation）存在于共享错误目录中，但此 API 不会返回该错误。在 Staging 环境测试
- 请按上述示例对 staging GraphQL 端点进行注册。参见 Staging 与生产环境。
- 对地址使用测试地址，以保证可确定性地通过验证——法定地址会经过真实的地址验证服务商，虚构街道将失败。
- staging 中的 EIN 仍须满足
XX-XXXXXXX格式，但无需对应真实实体。 - 所有者手机号必须为该国家/地区的“可能”号码。
+15551234567会失败，因为555不是美国已分配的区号；请使用真实区号配以555交换码，如+14155551234。 - 由于用户不能持有两个进行中的申请（
BS-0007），请用不同的测试用户来测试重复注册流程。
最佳实践
- 先在客户端进行校验。几乎所有错误代码都是你可以在发起网络请求前捕获的格式或选择问题。这将显著提升开户完成率。
- 预计一次只返回一个错误。校验在遇到第一个问题时即停止，且法定地址较早检查，因此被拒提交可能同时存在多个问题。
- 运行时获取类别。不要硬编码类别 UUID。
- 为每位所有者发送
isUsPerson。这是导致名单被拒的最常见原因。 - 不要在 KYB 被拒后自动重试。重新提交不会改变结果，且会产生重复案件。
- 立刻存储
accountId。它是你对该申请的唯一引用，也是支持团队会索要的凭据。 - 如实告知待审核状态。告知用户其企业正在审核及大致时长，而不是将其直接导向尚无法交易的企业控制台。
- 第一次就完整收集所有权信息。缺少实益所有者是审核停滞并追加文档要求的最常见原因。
备注
businessAccountUsage与businessAccountUsageOther必须至少提供一项。- 当用户已有进行中的申请时，不能注册新企业。
- 没有幂等键。重复提交会被进行中的申请检查所阻止。
- 校验在写入任何内容之前进行，且实体、申请、章程和地址记录在单个事务中创建——被拒提交不会留下任何数据。
- 你提交的
taxId会在存储前被代币化，且不会在任何读取操作中返回。
相关页面
KYB 概览
前置条件、端到端流程，以及如何跟踪案件直至决策。
业务类别
获取此变更所需的类别与子类别 ID。
提交企业文件
上传授权文件并响应 KYB 补充资料请求。
企业 KYB 状态
提交后读取 KYB 状态及各所有者的验证进度。
所有者验证链接
为走证件路径的所有者生成身份验证链接。
地址格式要求
规范企业法定地址与所有者地址对象的规则。