术语定义

1. 主商户
   通过网关模式接入发卡API的主体客户。

• 主商户拥有独立的量子账户。
• 接入前，主商户需前往 https://www.qbitnetwork.com/ 进行注册、开户并完成 KYB 企业认证。

2. 子商户
   由主商户引入的下级客户，可为个人或企业用户。

• 每个子商户都拥有独立的量子账户。
• 注意
  • 当前仅支持个人用户在线完成开户流程。
  • 若需开户企业子商户，请联系您的客户经理，提交线下材料进行处理。

账户结构

下图展示了网关模式下的账户结构：

关键要点

1. 账户独立性：

• 每个子商户均拥有独立的量子账户。
• 除交易手续费收取场景外，主商户与子商户账户之间无资金交互。

2. 资金隔离与安全性：

• 子商户资金完全隔离，保障资产安全。
• 子商户之间无直接关联，确保系统稳定与合规性。

API对接流程

以下为主商户与子商户账户设置的完整 API 对接流程：

主商户设置流程

1. 注册与KYB认证

• 主商户需在 https://www.qbitnetwork.com/sign-up 注册并提交 KYB 企业资质材料
• 审核通过后，请联系技术支持团队获取生产环境访问凭据并配置相关参数（如 webhook URL）

子商户设置流程

1. 创建子商户账户
   使用创建账户API创建子商户账户。

• 接口：创建一个账户 (v1)
• 用途：将子商户注册绑定至主商户名下

2. 提交子商户KYC认证信息
   使用提交KYC接口提交身份验证信息。

• 接口：提交KYC (v2)
• 可选方式：
  • 使用 SumSub Share Token（共享令牌）共享KYC信息 (SumSub Account KYC)
  • 直接通过账户API提交完整KYC信息 (Account KYC)
• Qbit 将负责审核并通过Webhook反馈结果

3. 初始化子商户账户
   当KYC审核通过后，需初始化子商户账户。

• 接口：账户初始化 (v2)
• 用途：自动创建子商户的量子账户

4. 为量子账户转账
   如有需要，可由主账户向子商户的量子账户划转资金。
   接口：创建交易（v1)

API流程示例

1. 主商户开户：

• 注册并完成 KYB 认证

2. 子商户开户流程：

• 创建子商户账户 → 提交KYC信息 → 初始化账户 → 为量子账户转账（如有需要）