📄 正文
创建用户是接入合作伙伴自管模式的第一步。无论您的终端用户来自交易所、钱包还是项目方应用，都可以通过一次调用将其登记到 DCS 系统，为后续 KYC 和发卡做好准备。DCS 会在这一步为每位用户分配全局唯一的用户 ID（customerId），并安全存储其基本联系信息。
用户是后续流程的起点
在合作伙伴自管模式里，额度由接入机构掌握、授权由接入机构决策，但「用户」这一身份实体仍由 DCS 统一管理。一个用户创建成功后，您拿到的customerId 会贯穿后续所有动作：
customerId，它是后续接口的必填关联键。
谁做什么
前置条件
- 已拥有企业（Enterprise）的
ApiKey/SecretKey，并已按照鉴权要求构造请求头（含 HMAC-SHA256 签名与 Nonce）。如尚未配置，请先参阅 入驻指南 与 鉴权。 - 已为请求设置
Content-Type: application/json。
接口
POST /open-api/customer/v1/create-customer
请求参数
关于明文与密文（必读） 手机号、邮箱两组字段均为「明文 / 密文二选一」：
- 若以明文传输，直接填
phone/- 若需在传输层之外再做一层加密（推荐对 PII 敏感的接入机构使用），改填
phoneEncryption/emailEncryption，并同时提供encryptionIV。加密算法为 AES-GCM。- 同一字段明文与密文同传时，系统以密文为准。
字段说明phoneCountryCode（国家码）与phone（须以+开头、带国家前缀）会同时携带国家码信息。两者当前都必须提供：phoneCountryCode作为 libphonenumber 的 2 位 ISO region，phone使用完整 E.164 格式；两者代表的国家必须一致。
最小请求示例（明文）
最小请求示例（密文）
响应示例
响应字段（data）
统一响应结构
所有合作伙伴自管接口返回统一结构{ code, message, messageDetail, data }：
下一步
用户创建成功、拿到customerId 后，下一步是为该用户 申请 KYC 认证。KYC 通过后即可 申请卡片。