如果你的卡产品只需要基础字段（Simplified KYC），现有的持卡人创建流程可以照常使用，无需改动。通过 List Products 查询产品要求的字段。
概览
前置条件
调用 API 之前，先获取 Access Token：x-auth-token 请求头传入返回的 auth_token。
步骤1：检查产品要求
调用 List Products 查看目标产品要求哪些字段。required_fields 数组。Enhanced KYC 产品的必填字段会包含 identity、residential_address 和 kyc_verification。以下是一个 Enhanced 产品的示例（BIN 46651711）：
required_fields 告诉你具体需要哪些信息。只有标注 "required": true 的字段是必填的 —— 可选字段可以省略。步骤2：使用 Enhanced KYC 创建持卡人
调用 Create Cardholder，传入完整的必填字段以及kyc_verification。
residential_address.country 和 nationality 字段受地区限制约束。支持的国家和受制裁的国籍清单参见 持卡人地区限制。Enhanced 卡的字段限制：
first_name与last_name的总长度不能超过 26 个字母。residential_address.postal_code长度必须为 4–10 位（含两端）。
方式 A：SUMSUB_REDIRECT
如果你希望 UQPAY 通过 Sumsub 处理身份验证，使用此方式。你会收到一个 IDV URL 用于重定向持卡人。INCOMPLETE 状态，并附带一个 IDV 链接：
idv_verification_url 完成身份验证，然后等待 webhook 通知（见步骤3）。
方式 B：THIRD_PARTY
如果你已通过自有 KYC 服务商完成持卡人身份验证并有凭证引用，使用此方式。kyc_proof.reference_id 至少 10 个字符，全局唯一。附上合规报告
kyc_proof.documents 承载第三方验证背后的合规报告文件。先用 上传文件 上传每个文件拿到 file_id，再在这里通过 report_type 引用它。
必须包含一份身份验证报告；反洗钱报告为可选。根据你的服务商出具报告的方式，有两种上送方式：
响应 —— 持卡人立即完成验证：
步骤3：等待 KYC 审核通过（仅 SUMSUB_REDIRECT）
如果你使用了SUMSUB_REDIRECT，订阅 cardholder.kyc.status_changed webhook 以实时接收 KYC 状态变更。
Webhook payload 示例（KYC 已通过）：
cardholder_status 变为 SUCCESS 时，持卡人即可签发卡片。
持卡人处于
PENDING 状态时无法签发卡片。请先等待 KYC 审核通过。步骤4：创建卡片
当cardholder_status 为 SUCCESS 后，调用 Create Card：
下方示例使用沙盒环境的
card_currency: "USD"。生产环境下请将 card_currency 设置为 XUSD。错误处理
建卡时 KYC 信息不足
如果持卡人尚未满足产品的 KYC 要求就尝试创建卡片，你会收到如下错误，其中missing_fields 指明仍需补齐的字段：
- 先通过 Update Cardholder 更新持卡人信息，然后重试建卡。
- 在 Create Card 请求中通过
cardholder_required_fields字段内联补充缺失的信息。
持卡人处于 PENDING 状态
持卡人cardholder_status 为 PENDING 时创建卡片会被拒绝。请等待 KYC 审核完成后再重试。