> ## 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.

# 電子署名の警告とリスクコード一覧

> Didit電子署名の全警告を解説。SIGNATURE_DECLINEDからSIGNATURE_DOCUMENT_CHANGEDまで、発生のトリガーと制御するルールを紹介します。

[電子署名](https://docs.didit.me/ja/core-technology/electronic-signature/overview.md)ステップは、署名者が署名できない場合や署名しない場合に警告を発生させます。具体的には、署名者が署名を拒否した場合、コードを使い切った場合、本人確認済みの本人情報と照合できない場合、または書類が署名者に提示された内容と一致しなくなった場合です。警告はいずれもその署名者の署名を停止するため、その署名者について署名済み書類は発行されません。警告が判定にどう影響するかは、お客様が決定します。

## 概要

警告は次の2か所に表示されます。

* 署名者の`signatures[]`の項目で、`warnings[]`内に`{ "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }`として表示されます。[電子署名レポート](https://docs.didit.me/ja/core-technology/electronic-signature/report-electronic-signature.md)を参照してください。
* セッションのアクティビティで、機能`SIGNATURE`のタグが付き、タイトルと説明とともに表示されます。コンソールではセッションの**Signature**タブに表示され、`additional_data.signature_id`が該当する署名者を指します。

各コードはルールに対応しています。ワークフローのステップごとに、コンソールの**Rules**タブまたはステップの[設定](https://docs.didit.me/ja/management-api/workflows/feature-configs.md#電子署名)で、ルールを`DECLINE`、`REVIEW`、`NO_ACTION`のいずれかに設定します。ルールによって、署名者の`verdict`（`Declined`、`In Review`、`Approved`）と警告の重要度（`error`、`warning`、`information`）が決まります。ステップのカスタムステータスルールは、その後に適用されます。

> [!WARNING]
>
> ルールが決めるのは判定であり、書類が署名されるかどうかではありません。`NO_ACTION`ではワークフローは続行しますが、署名者は署名していないままです。署名に依拠する前に、`status`が`signed`であることを確認してください。

## 発生する警告

| コード | 発生する条件 | ルールとデフォルト |
| - | - | - |
| `SIGNATURE_DECLINED` | 署名者が署名を拒否しました。署名済みのコピーは発行されず、料金も発生しません。 | `signature_declined_action`、デフォルトは`REVIEW` |
| `SIGNATURE_OTP_FAILED` | 署名者が誤ったコードを3回入力したか、5回を超えてコードを要求しました。 | `signature_otp_failed_action`、デフォルトは`DECLINE` |
| `SIGNATURE_NAME_MISMATCH` | KYB：主要人物について申告された氏名が、本人確認済みの氏名と一致しません（大文字・小文字と空白の違いは無視されます）。 | `signature_name_mismatch_action`、デフォルトは`DECLINE` |
| `SIGNATURE_IDENTITY_NOT_VERIFIED` | 署名者に氏名を含む承認済みの本人確認がない、セッション内のライブネスチェックが承認されていない、または署名者が開始した後に本人確認が変更されました。 | `signature_identity_not_verified_action`、デフォルトは`DECLINE` |
| `SIGNATURE_DOCUMENT_CHANGED` | 書類が、署名者に提示された時点で記録されたSHA-256と一致しなくなりました。 | `signature_document_changed_action`、デフォルトは`DECLINE` |

本人確認と氏名のチェックは、署名者がコードを要求したときと、コードを入力したときにもう一度実行されます。そのため、これらの警告はステップを開いた時点ではなく、これらの時点で表示されます。

## 拒否後の再開

`SIGNATURE_DECLINED`は、署名者が取り消せる唯一の警告です。署名リンクが有効な間は、署名を拒否した署名者はステップを再度開いて署名できます。再開すると、その署名者の警告と、各書類に対する閲覧と同意の記録がクリアされるため、署名者は書類をもう一度確認することになります。ステップの署名者のうち拒否したままの人がいなくなると、警告はセッションのアクティビティから削除されます。再開してもコードの試行回数はリセットされません。その他の警告は、その署名者が取り消すことはできません。

## 署名者に表示される問題

以下の状況では、警告を表示せずに署名者の操作が停止します。フローには発生した状況が表示されます。

| 状況 | 動作 |
| - | - |
| 署名リンクの期限切れ | `expires_at`以降は、ステップを開くことも完了することもできません。リンクの有効期間は、セッション作成時から`signature_link_validity_days`日間です。 |
| コードの期限切れ | コードの有効期間は5分です。署名者は新しいコードを要求します。 |
| 新しいコードの要求が早すぎる | 署名者はコードを要求するたびに60秒待つ必要があります。 |
| 確認済みの連絡先がない | コードは、セッション内で事前に確認されたメールアドレスまたは電話番号にのみ送信されます。署名ステップの前にメールアドレス認証または電話番号検証を追加してください。 |
| 必須フィールドが空 | 署名者は、書類内のすべての必須フィールドに値が入力されるまで、その書類を完了できません。フローには残りの件数が表示され、最初の未入力フィールドに移動します。 |
| フィールドの値が拒否される | フィールドの[検証](https://docs.didit.me/ja/core-technology/electronic-signature/overview.md#検証)に違反する値（長すぎる、数値でないなど）は拒否され、フローにその理由が表示されます。 |
| アプリが古くフィールドに未対応 | フィールドに対応していないネイティブSDKのリリースでは、フィールドを含む書類を表示できず、ステップにエラーが表示されます。フィールドのない書類は引き続き利用できます。[署名体験](https://docs.didit.me/ja/core-technology/electronic-signature/overview.md#署名の体験)を参照してください。 |

## 例

```json theme={null}
{
  "signatures": [
    {
      "id": "0e6c2a8e-6c2f-4b8e-9a51-3f2f6a7d9b10",
      "node_id": "feature_signature",
      "status": "declined",
      "verdict": "In Review",
      "warnings": [
        { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }
      ],
      "declined_at": "2026-11-03T10:41:40.320Z",
      "declined_action": "REVIEW",
      "signed_at": null,
      "certificate": null,
      "timestamp": null,
      "evidence_file": null
    }
  ]
}
```

この例では、変更されるフィールドのみを示しています。[署名オブジェクト](https://docs.didit.me/ja/core-technology/electronic-signature/report-electronic-signature.md#署名オブジェクト)のその他のフィールドもすべて存在します。

## 警告の種類

各警告の重要度は、設定したルールに基づいて決まります。重要度は次の3つのカテゴリーに分かれます。

## 関連情報

* [電子署名の概要](https://docs.didit.me/ja/core-technology/electronic-signature/overview.md)
* [電子署名レポート](https://docs.didit.me/ja/core-technology/electronic-signature/report-electronic-signature.md)
* [ワークフロー機能の設定](https://docs.didit.me/ja/management-api/workflows/feature-configs.md#電子署名)


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