# 検証ワークフローの構築

Source: https://help.didit.me/ja/workflows/build-a-verification-workflow
Updated: 2026-10-12

ワークフローとは、本人が完了するチェックの組み合わせと、各結果で何が起きるかを定義したものです。構築方法、公開方法、意図しない挙動を招く間違いの避け方を解説します。

ワークフローは**アプリケーションごと**に存在するため、まず正しいアプリケーションにいるか確認してください。標準的なフローにはSimpleモードで、分岐が必要な場合はAdvancedモードで構築し、**公開**してください - ドラフトのままでは反映されません。セッションは開始時のバージョンを維持するため、変更が影響するのは新しいセッションだけです。

[Video: コード不要でKYC検証ワークフローを構築する - Didit Academy](https://www.youtube.com/watch?v=7-nJ3JE20i4)

[Video: 電話番号認証：SMS、WhatsApp、Viber、TelegramでOTPを送信 - Didit Academy](https://www.youtube.com/watch?v=mybuK4SbU6o)

[Video: メール認証：OTPコード、使い捨てメール、漏えいメール - Didit Academy](https://www.youtube.com/watch?v=4zUl0o9bS0o)

**ワークフロー**とは、本人が通過するチェック - 身分証明書、ライブネス、顔照合、AMLなど - と、それぞれの結果で何が起きるかを定義する場所です。すべての検証セッションはワークフローに対して実行されます。

## どこで構築するか

**本人確認 → ワークフロー → 新しいワークフロー**を開きます。個人のKYCか企業のKYB、シンプルか詳細モード、テンプレートを選び、**下書きを作成**を押します。アプリとLiveまたはSandbox環境を確認してください。行メニューから別のアプリにコピーできます。

![Diditコンソールのワークフロー一覧](https://help.didit.me/screenshots/workflows-list-light.webp)

*ワークフローは、あなたがいるアプリケーションに紐づいています。*

## 2つの構築方法

[Video: シンプル版と高度版のワークフロービルダー - Didit Academy](https://www.youtube.com/watch?v=X6KBx-S_uvQ)

1. **Simpleモード**

   テンプレートを選び - **KYC**、**適応型年齢確認**、**生体認証による再認証**、**住所確認**のいずれか - 使いたいチェック（ライブネス、顔照合、AML、NFC、電話、メールなど）をオン・オフで切り替えます。標準的なフローを最速で稼働させる方法です。

2. **Advancedモード**

   ビジュアルなグラフビルダーを使って条件分岐を追加します。国、書類タイプ、年齢、あるいはチェックの結果によって人を振り分け、異なる結果を異なる経路に送れます。「これらのチェックを順番に実行する」以上のロジックが必要な場合に使います。

3. **公開**

   公開済みの版は読み取り専用です。**ワークフローを編集**で新しい下書きを開いて公開します。**バージョン履歴**では以前の版を復元できます。進行中のセッションは開始時の版を使い続けます。

## 銀行口座と位置情報の確認

アプリケーションで有効な場合、**銀行口座確認**または**位置情報確認**をワークフローに追加できます。銀行設定には接続、本人情報との照合、リスク指標、判定、収集データがあり、対応国や金融データはプロバイダーと有効な機能によります。位置情報では精度、データの鮮度、許可エリア、権限拒否・取得不能・ルール不一致時の対応を設定します。取得した証拠はセッションの**銀行**または**位置情報**で確認します。設定が表示されても、すべてのプロバイダーやクライアントが対応するとは限りません。

## 見た目以上に重要な順序

拒否するよう設定されたステップは**ワークフローを停止させる**ため、ステップの順序は、ユーザーの体験と支払う金額の両方を左右します。高額なチェックの前に安価なリスクチェックを置けば、高額な部分に料金を払う前にトラフィックをふるいにかけられます。

全体像は[判定ルールとしきい値](https://help.didit.me/ja/workflows/decision-rules)にあります。これを読んだ次に読むべき記事です。なぜならワークフローのステップは、その挙動のほんの半分に過ぎないからです。

## 追加できるすべてのモジュール

| カテゴリー | モジュール |
|---|---|
| 書類 | ID検証、NFC、Document AI、住所証明 |
| 生体 | パッシブライブネス、アクティブライブネス、顔照合1:1、顔検索、生体認証、年齢推定 |
| 連絡先 | 電話認証、メール認証 |
| データ | データベースバリデーション、アンケート |
| リスク | AMLスクリーニング、AML継続モニタリング、デバイス・IP分析 |

KYBでは企業登記、企業AML、書類、主要関係者を確認できます。
有効にしたものそれぞれが完了セッションの料金に加算され、月次のプランクレジットがその支払いに使われます（Freeプランのクレジットでは電話番号確認は支払えません）。複数の機能を一度にオンにする前に、[何が課金対象のチェックになるか](https://help.didit.me/ja/billing-credits/what-counts-as-billable)をご覧ください。

## ワークフローIDを見つける

各ワークフローには一意のIDがあり、コンソールの**Workflows**ページに表示されます。API経由でセッションを作成する場合に必要になります。[連携方法](https://help.didit.me/ja/integration/integration-options)をご覧ください。

## チェックが失敗したときの挙動を制御する

デフォルトでは、チェックが失敗するとセッションは拒否され、本人には最後に検証が成功しなかったことが伝えられます。どのチェックがなぜ失敗したかは、セッションの詳細で正確に確認できます。**Advancedモード**では、各結果の行き先を自分で振り分けられます。**Declined**に送るか、チームメンバーが最終判断を下せるよう**In Review**に送るかを選べます。

各結果がどのように見えるかは[各セッションステータスの意味](https://help.didit.me/ja/verification-sessions/session-statuses)を、失敗したステップだけをやり直させたい場合は[検証をもう一度試してもらう](https://help.didit.me/ja/verification-sessions/retry-a-verification)をご覧ください。

## ワークフローが意図しない挙動をする原因

実際に起きる順番で挙げます。

1. **別のワークフロー、または別のアプリケーションのコピーを編集していた。** ワークフローIDを、自社のセッションが使っているものと照合してください。
2. **ドラフトが一度も公開されていなかった。** 保存されたドラフトはライブバージョンではありません。
3. **古いセッションでテストしていた。** セッションは作成時点の設定を維持します。新しいセッションを作成してください。
4. **書類タイプは許可されているが、サブタイプが選択されていない** - これはすべてに一致するのではなく、何にも一致しません。[対応している書類と国](https://help.didit.me/ja/documents-coverage/supported-documents-and-countries)をご覧ください。
5. **前のステップが拒否してフローを止めていた** ため、テストしたいステップが一度も実行されていませんでした。
6. **複製したワークフローがすべてを引き継いでいなかった。** ワークフローを複製した後は、きれいなコピーができたと決めつけず、必要なステップとルールを確認してください。

> **Note:** **Questionnaire**チェックの国コード一覧は、大多数の国をカバーしています。必要なコードが見当たらない場合は、対応していないと決めつけずサポートに問い合わせてください。

## 実ユーザーに見せる前にテストする

アプリケーション名の下の切り替えで**Sandbox**を選び、テスト用APIキーを作成して使用します。チェックはシミュレーションされ、課金されず、結果を指定できます。

[サンドボックスでのテスト](https://help.didit.me/ja/getting-started/sandbox-and-testing)

## 次のステップ

- 各結果が何をするかを設定する: [判定ルールとしきい値](https://help.didit.me/ja/workflows/decision-rules)
- フローを自社ブランドに合わせる: [ブランディングと検証体験のカスタマイズ](https://help.didit.me/ja/workflows/customize-branding-and-experience)
- コード不要でセッションを開始する、あるいはAPIで自動化する: [連携方法](https://help.didit.me/ja/integration/integration-options)
- 完全な技術リファレンス: [Workflows](https://docs.didit.me/console/workflows)