> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 認証リンク：ホスト型KYCのURLとQRコード

> Didit のコンソールまたはAPIから、安全な認証リンクとQRコードを作成できます。フロントエンド開発は不要で、ホスト型の本人確認を数分で開始できます。

認証リンクは、Didit が完全にホストする検証フローへエンドユーザーを誘導する、一意で安全なURLです。検証のステップとロジックはBusiness Consoleで設計し、ユーザーインターフェース、データの取得、セキュリティはDiditが担います。これにより、多くの場合コードを書かずに、堅牢な検証プロセスを数分で開始できます。

この方法は**Orchestrated Workflows**の連携方式の一つで、ワークフローエンジンの能力を最大限シンプルな形で活用できます。

***

## 仕組み

**1. ワークフローを設定する**

[Didit Business Console](https://business.didit.me)のノーコードエディターで、必要なチェックを必要な順序で並べたワークフローを設計します(例: 本人確認書類のスキャン → ライブネスチェック → AMLスクリーニング)。各ワークフローには一意の`workflow_id`があります。

**2. 認証リンクを生成する**

ユーザーごとに一意のセッションを作成します。Business Consoleから直接**ノーコード**で作成することも、[Create Session](https://docs.didit.me/ja/sessions-api/create-session.md)エンドポイントへの1回のAPI呼び出しで**ローコード**で作成することもできます。

**3. リンクを共有する**

生成されたURLを、メール、SMS、アプリ内メッセージなど任意のチャネルでユーザーに送信するか、iframeに埋め込みます。

**4. 結果をリアルタイムで受け取る**

ユーザーが検証を進める間と最終的な検証結果が確定した時点で、Diditは設定済みの[Webhook URL](https://docs.didit.me/ja/integration/webhooks.md)に更新情報を自動送信します。

***

## 認証リンクの生成

### 方法1: ノーコードでの生成(Business Console経由)

すぐに始めたい場合、手動のプロセス、開発リソースのないチームに最適な方法です。

1. [Didit Business Console](https://business.didit.me)の**Verifications**セクションに移動します。
2. **+ Create Verification**をクリックします。
3. このセッションで使用する`workflow_id`を選択します。
4. 必要に応じて`vendor_data`(自社システムのユーザーIDなど)を入力し、認証を自社のユーザーに紐付けます。
5. **一意のURLとQRコード**が即座に生成されます。
6. リンクをコピーするか、ユーザーにQRコードをスキャンしてもらうか、ユーザーのメールアドレスにリンクを直接送信します。

### 方法2: ローコードでの生成(API経由)

この方法は完全な自動化が可能で、認証リンクをアプリケーションのロジックに組み込む標準的な方法です。

APIキーと`workflow_id`を指定して、`/v3/session/`エンドポイントに`POST`リクエストを1回送信します。

```bash theme={null}
curl --request POST \
     --url https://verification.didit.me/v3/session/ \
     --header 'x-api-key: YOUR_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
       "workflow_id": "550e8400-e29b-41d4-a716-446655440000",
       "vendor_data": "your_internal_user_id_123",
       "callback": "https://yourapp.com/didit/webhook/handler"
     }'
```

APIは、`session_id`と一意の検証用`url`を含むJSONオブジェクトを返します。

```json theme={null}
{
  "session_id": "11111111-2222-3333-4444-555555555555",
  "session_number": 1234,
  "vendor_data": "your_internal_user_id_123",
  "status": "Not Started",
  "workflow_id": "550e8400-e29b-41d4-a716-446655440000",
  "callback": "https://yourapp.com/didit/webhook/handler",
  "url": "https://verify.didit.me/session/abcdef123456"
}
```

> [!NOTE]
>
> APIの詳細は[Create Session APIリファレンス](https://docs.didit.me/ja/sessions-api/create-session.md)を参照してください。

***

## 認証リンクを使うべき場面

> [card] 市場投入までのスピード
>
> 安全でコンプライアンスに準拠した検証プロセス一式を、数週間ではなく数時間で開始できます。

> [card] フロントエンド開発が不要
>
> 書類の撮影、ライブネスチェック、ユーザーへのガイダンスといったユーザーインターフェース全体を、Diditの構築済みUIに任せられます。

> [card] マルチチャネルでの配信
>
> メール、SMS、サポートチャット、その他のあらゆるコミュニケーションチャネルで検証リクエストを送信できます。

> [card] 対面でのオンボーディング
>
> ユーザーが自分のデバイスで検証を完了する必要がある対面のシーンでは、QRコードを利用できます。

***

## 次のステップ

* **最初のワークフローを設定する**: [Business Console](https://business.didit.me)で検証の流れを設計します。
* **Webhookを設定する**: [Webhookの処理](https://docs.didit.me/ja/integration/webhooks.md)ガイドで、ステータス更新をリアルタイムで受け取る方法を確認します。
* **Unilinksを試す**: 再利用可能でバックエンド不要の代替手段については、[Unilinks](https://docs.didit.me/ja/console/uni-links.md)を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.