個人入駐 API 工作流程
使用此對照將個人 KYC 政策連接至當前所生成的 API 參考。請在每一步都跟隨當前資源,而不要以面向政策的標籤實作 API 狀態機。工作流程對照
1. 建立個人客戶
使用POST /v3/customers 建立客戶。儲存回傳的 customer 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。請依當前的待辦任務 ID 執行,而不是從先前的回應推論就緒狀態。
4. 取得當前任務細節
使用GET /v3/customers/{customerId}/tasks 列出客戶任務。使用 GET /v3/customers/{customerId}/tasks/{taskId} 讀取經授權的動作面。
任務細節可能會暴露第一方託管的 session URL 與當前可執行的要求。請使用其當前的版本與狀態。
5. 完成託管 session 或提交任務答覆
當任務細節提供託管 session 時,僅將必要的 session 資料回傳給您的用戶端,並將 API 金鑰保留於後端。 當任務要求答覆時,使用POST /v3/customers/{customerId}/tasks/{taskId}/submissions 建立一次完整不可變的嘗試。使用 GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId} 讀取當前提交與其公開結果。
6. 僅在被要求時上傳文件
僅在當前任務要求時上傳文件。使用POST /v3/customers/{customerId}/documents,然後將回傳的 document id 放入對應的文件答覆中。