Skip to main content

個人オンボーディング 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. 現在のケイパビリティと application を読み取る

GET /v3/customers/{customerId}/capabilities/{capabilityId} および GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications を読み取ります。以前のレスポンスから ready を仮定するのではなく、現在のオープンタスク ID に従ってください。

4. 現在のタスクの詳細を取得する

GET /v3/customers/{customerId}/tasks で顧客タスクを一覧表示します。GET /v3/customers/{customerId}/tasks/{taskId} で認可されたアクションサーフェスを取得します。 タスクの詳細は、ファーストパーティのホスト型セッション URL と、現在の実行可能な要件を露出できます。その現在のリビジョンとステータスを使用してください。

5. ホスト型セッションを完了する、またはタスク回答を送信する

タスクの詳細がホスト型セッションを提供する場合は、必要なセッションデータのみをクライアントに返し、API キーをバックエンドに保持してください。 タスクが回答を要求する場合は、POST /v3/customers/{customerId}/tasks/{taskId}/submissions で完全な不変の試みを 1 回作成してください。1 つの現在の送信とその公開結果を GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId} で読み取ります。

6. 要求された場合にのみドキュメントをアップロードする

ドキュメントは、現在のタスクが要求する場合にのみアップロードしてください。POST /v3/customers/{customerId}/documents を使用し、返されたドキュメント ID を該当するドキュメント回答に配置してください。

7. 現在のリソースを再取得する

各イベントまたはアクションの後で、現在の顧客、ケイパビリティ、application、およびタスクを再取得してください。最新の状態、理由、要件、およびオープンタスク ID を使用して、次のステップを選択してください。

生成された操作マップ

ポリシーと実装ガイダンス

Simplified、Standard、Enhanced KYC はポリシー階層です。現在のケイパビリティ、application、タスク、送信、要件、ホスト型セッションの状態を置き換えるものではありません。 実装の詳細については、個人オンボーディングガイドケイパビリティとタスク、および インテグレーションドキュメントガイド に従ってください。