个人入驻 API 流程
请使用本映射,将个人 KYC 政策与当前生成的 API 参考对接起来。每一步都请以当前资源为准,不要将面向政策的标签实现为 API 状态机。流程映射
1. 创建个人客户
使用POST /v3/customers 创建客户。保存返回的客户 id,并使用 GET /v3/customers/{customerId} 读取当前资源。
2. 发现并申请符合条件的能力
读取GET /v3/customers/{customerId}/capabilities/supported。仅当某个变体当前的可用性和资格允许申请时,才使用 POST /v3/customers/{customerId}/capabilities/{capabilityId} 进行申请。
3. 读取当前的能力与申请
读取GET /v3/customers/{customerId}/capabilities/{capabilityId} 与 GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications。请按当前的 open task id 推进,不要基于更早的响应就断定能力已就绪。
4. 获取当前任务详情
使用GET /v3/customers/{customerId}/tasks 列出客户任务。使用 GET /v3/customers/{customerId}/tasks/{taskId} 获取有权限的可执行操作面。
任务详情可能会展示第一方托管会话 URL 以及当前可执行的要求。请使用其当前的版本与状态。
5. 完成托管会话或提交任务答案
当任务详情提供托管会话时,请仅将必要的会话数据返回给您的客户端,并将 API 密钥保留在您的后端。 当任务要求提交答案时,使用POST /v3/customers/{customerId}/tasks/{taskId}/submissions 创建一次完整、不可变的提交尝试。使用 GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId} 读取当前的一次提交及其对外可见的结果。
6. 仅在被请求时上传材料
仅在当前任务要求时才上传材料。使用POST /v3/customers/{customerId}/documents,然后将返回的 document id 填入对应的材料答案。