KYB連携ガイド：アーキテクチャと実装パターン

​

アーキテクチャ

​

認証

​

セッションの作成

​

ホスト型リンクの配信

• 自社のプラットフォームからメールで送信する。
• オンボーディングUIにリンクとして埋め込む。
• アプリ内のWebView(iOS / Android / React Native)で開く。

​

ポーリングとWebhookの比較

• GET /v3/session/{id}/decision/を指数バックオフでポーリングします(最初は10秒ごと、最大60秒間隔まで)。
• statusが"Approved"、"Declined"、"In Review"のいずれかになったらポーリングを停止します。

​

Webhookの処理

• status.updated: セッションのステータスが変更されました。KYBセッションはsession_kind === "business"でフィルターしてください。
• data.updated: レビュアーがコンソールで登記データや主要人物を編集したか、法人登記から変更が報告されました。申請者が書類をアップロードしたり主要人物を送信したりした場合には送信されないため、その場合はstatus.updatedを確認してください。同じsession_kindフィルターが適用されます。
• business.status.updated / business.data.updated: 紐付けられた企業エンティティが変更されました。

​

判定の処理

switch (decision.status) {
  case 'Approved':
    await onboardBusiness(decision);
    break;
  case 'Declined':
    // The KYB decision has no single reason code: collectWarnings is your helper
    // that flattens warnings[] from registry_checks, document_verifications,
    // key_people_checks and aml_screenings
    await logRejection(collectWarnings(decision), decision);
    break;
  case 'In Review':
    // Wait for analyst decision — another webhook will fire
    await markPending(decision);
    break;
  case 'Resubmitted':
    // The business was asked to re-upload a document
    await notifyBusiness(decision);
    break;
}

​

再提出フロー

• 同じurlを再配信する: ホスト型フローは再提出が必要な箇所から再開されます。
• 無効になった主要人物のリンクを再発行する: 子KYCセッションが削除された、または本人が開始する前に期限切れになった関係者には、主要人物のKYCセッションの再生成で新しいセッションを発行します。
• Business Consoleでケースを作成する: 社内でのやり取りを追跡できます。

​

自社のフロントエンドからステップを実行する

1. セッションがKYB書類ステップにある間に、法人書類をアップロードします。
2. 株主や所有比率を含め、書類に記載された関係者を読み取り、申請者に表示します。
3. 作成を編集、削除、関係者の下書きします。下書きは申告扱いにならず、料金も発生しません。
4. 下書きを送信します。Diditは認証が必要な関係者を判断し、それぞれにKYCセッションを作成して、送信または埋め込み用のkyc_session_urlを返します。
5. ホスト型フローと同様に、セッションから統合された判定を読み取ります。

​

企業プロファイルの集約

• 定期的な再KYBフローが同じプロファイルに追加されます。
• 同じvendor_dataに対して監視される取引に、企業のリスクコンテキストが引き継がれます。
• ユーザーエンティティに紐付けられたUBOや役員によって、エンティティ間の関係が構築されます。

​

ベストプラクティス

​

エラー処理

​

次のステップ