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

# 電子署名API：KYC後に書類へ署名

> Diditの電子署名は、本人確認済みの本人や法人の代表者が、検証フローの中でPDFとWord文書に高度電子署名で署名できる機能です。

Didit電子署名は、本人確認を終えたばかりの人が、同じフローの中で御社の書類に署名できる機能です。署名者は各書類を確認し、署名、イニシャル、求められたデータを追加して、先に検証したメールアドレスまたは電話番号に届くワンタイムコードで確定します。Diditは、各書類を高度電子署名（AES）で署名して返し、署名と検証済みの本人を結び付ける証拠PDFも提供します。署名者が本人確認済みの本人となるユーザー認証（KYC）と、法人の法定代理人や主要関係者が法人に代わって署名する法人確認（KYB）の両方で利用できます。

電子署名の連携プロンプト
        Copy prompt to clipboard



      
      

\<pre>

\`Goal:
Add Didit Electronic Signature to a verification workflow: the verified person (KYC) or a company's representatives (KYB) sign PDF or Word documents inside the Didit flow, and your backend receives the signed PDFs and the evidence.

Delivery mode:
Electronic Signature is a workflow step (feature SIGNATURE). There is no standalone signing API: the signer signs inside the hosted Didit flow, the Web SDK or a native SDK.

Prerequisites in the workflow:
\- KYC: an ID Verification step before the signature step (the signer's identity must be Approved), plus Email Verification (email codes, the default) or Phone Verification (SMS codes) so the code goes to a verified contact. If the workflow has Liveness, it must be Approved too.
\- KYB: a Key People step whose people complete their own KYC with the same prerequisites. signature_signer "legal_representative" picks the key people with the role representative or authorized_signatory; "key_people" picks every eligible key person (1 to 20 signers).

Steps:
1\. Add the Electronic Signature step to the workflow in the Business Console (or POST /v3/workflows/ with {"feature": "SIGNATURE", "config": {...}}). Upload the documents in the console, or set signature_documents_source to "session" (or "both") to send them per session.
2\. Optional: place fields on each document: signature, initials, full_name, date_signed, text, checkbox, email and read-only data. Workflow documents get their fields in the console's template editor. Session documents carry them in sign.documents[].fields, placed by page and position or by anchor text. Every field has a key; a field with prefill "api.<key>" takes its value from sign.field_values.
3\. Create a session. For per-session documents, send sign.documents with base64 content:

curl -X POST 'https://verification.didit.me/v3/session/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"workflow_id": "YOUR_WORKFLOW_ID",
"vendor_data": "user-1234",
"sign": {
  "documents": [
    \{
      "title": "Account agreement",
      "file_name": "agreement.pdf",
      "content_base64": "<base64 of the PDF>",
      "fields": [
        \{ "key": "signature", "type": "signature", "page": 3, "x": 0.09, "y": 0.62, "width": 0.36, "height": 0.085 },
        \{ "key": "credit_limit", "type": "data", "page": 1, "x": 0.34, "y": 0.31, "width": 0.3, "height": 0.03, "prefill": "api.credit_limit" }
      ]
    }
  ],
  "field_values": { "credit_limit": "3,000 EUR" }
}
}'

4\. Send the user to session.url (or open it with the Web or native SDK). Documents with fields need a native SDK release that supports fields; the hosted page and the Web SDK always do.
5\. Wait for the status.updated webhook, then GET /v3/session/{session_id}/decision/.

Decision surface:
signatures[] (one item per signer and signature step). Read:
\- status: the signing stage (intro, review, code, signing, signed, declined).
\- verdict: Not Finished | Approved | In Review | Declined.
\- level ("aes"), format ("pades"), profile ("PAdES-B-LT" once signed).
\- signer, identity_used, confirmation, certificate, timestamp, adopted_signature, electronic_signature_consent_at.
\- documents[]: mode ("fields" or "read_and_agree"), sha256_original, sha256_signed, status, signed_file (download path), source_format, conversion, fields[] (key, type, value, display_value, value_source, filled_at, image_url).
\- evidence_file (download path), warnings[] ({code, node_id}).

Downloads (x-api-key works):
\- GET /v3/session/{session_id}/signatures/{node_id}/documents/{document_id}/file/ -> signed PDF
\- GET /v3/session/{session_id}/signatures/{node_id}/evidence/?signature_id={id} -> evidence PDF
\- GET /v3/session/{session_id}/signatures/{node_id}/fields/{field_id}/image/ -> applied signature or initials (PNG); use the image_url of the field
\- POST /v3/session/{session_id}/signatures/{node_id}/validate/ -> re-checks the stored signatures

Warnings:
SIGNATURE_DECLINED (default REVIEW), SIGNATURE_OTP_FAILED, SIGNATURE_NAME_MISMATCH, SIGNATURE_IDENTITY_NOT_VERIFIED, SIGNATURE_DOCUMENT_CHANGED (default DECLINE), SIGNATURE_FIELD_DATA_MISSING (default REVIEW). Each maps to a signature_*_action setting.

Rules:
\- Level: "aes" only. "qes" is coming soon and saving it returns 400 qes_provider_not_configured.
\- PDF: up to 20 MB and 100 pages each, no password, scripts or attachments. Up to 20 documents and 50 MB per signer.
\- Word: .docx only (.doc, .docm, .odt and .rtf are refused with unsupported_type), up to 20 MB, converted to PDF while the upload or create-session request runs. Fields refer to the converted pages. Macros, tracked changes, external links and embedded objects are refused with signature_document_not_supported; a file that can't be converted returns signature_document_conversion_failed. Both carry a reason.
\- Fields: key matches ^[a-z][a-z0-9_]{0,63}$ and is unique in its document; role defaults to the step's signer; up to 200 fields per document and 500 per signer. Every role with fields on a document needs a signature or initials field. There is no date picker type: use text.
\- Treat a null certificate, timestamp or signed_file as "not signed". Never show success until status is "signed".

See also:
\- /core-technology/electronic-signature/report-electronic-signature
\- /core-technology/electronic-signature/warnings-electronic-signature
\- /management-api/workflows/feature-configs#electronic-signature`

\</pre>



      
      

Paste into

## 署名レベル| レベル | 提供状況 | 内容 |
| - | - | - |
| **AES**（高度電子署名） | 提供中 | 各書類に、PDFの署名形式であるPAdESで、長期検証プロファイル（`PAdES-B-LT`）を使って署名します。署名には、信頼できるタイムスタンプと、後から検証するために必要な失効データが含まれます。署名は、検証済みの本人情報と署名者が確定したワンタイムコードによって署名者に一意に結び付けられ、署名後に書類を変更すると署名は無効になります。 |
| **QES**（適格電子署名） | 近日提供 | 署名者に発行された適格証明書で署名します。コンソールではこのオプションが**近日公開**と表示され、APIで`signature_level: "qes"`を保存しようとすると`qes_provider_not_configured`とともに`400`が返ります。 |AESはPAdESのみで署名します。`signature_format`の値`xades`と`cades`は、AESでは`signature_format_not_supported`で拒否されます。## 仕組み**1. ワークフローがまず署名者を検証する**署名ステップは、署名者が誰かを確定するステップの後に実行されます。本人確認と、コードの送信先となる連絡先のメールアドレスまたは電話番号の認証です。[開始する前に](#開始する前に)を参照してください。**2. Diditが書類を準備する**署名者がこのステップに到達すると、Diditは書類とそのフィールドをセッションにコピーし、各書類のSHA-256を記録します。その後にワークフローを変更しても、この署名者に表示される内容は変わりません。**3. 署名者が各書類を確認する**フィールドのある書類では、署名者はフィールドからフィールドへ案内されます。署名は一度採用すれば、すべての署名フィールドとイニシャルフィールドに適用され、テキストとチェックボックスのフィールドには入力します。検証済みの本人情報、セッション、または御社のシステムからDiditが取得した値は、すでにページに入力されています。フィールドのない書類では、署名者は内容を読んで同意します。**4. 署名者がコードで確定する**いずれかの書類にフィールドがある場合、署名者はまず書類に電子的に署名することに同意します。その後Diditは、セッションの前半で検証したメールアドレスまたは電話番号に、6桁のコードを送信します。コードを入力すると、そのステップのすべての書類への署名が承認されます。**5. Diditが署名して封印する**Diditは署名日を入力し、すべてのフィールド値を各PDFに刻印し、証拠ページを追加してから、PAdES署名とタイムスタンプを適用します。そのため、署名はページ上のすべての内容を対象にします。**6. 結果を受け取る**判定結果とセッションのWebhookには、署名者、確定情報、証明書、タイムスタンプ、各書類のハッシュ、すべてのフィールドの値を含む`signatures[]`が含まれます。署名済みPDFと証拠PDFをダウンロードでき、Diditは署名者にコピーをメールで送ることもできます。## 開始する前に署名者は、署名する前に検証されている必要があります。Diditは、御社や署名者が入力した内容ではなく、セッション自身の検証済みの記録から、氏名と連絡先を取得します。**ユーザー認証（KYC）の場合**は、ワークフローで電子署名の前に次のステップを置きます。- 判読可能な氏名を持つ、承認済みの**本人確認**。これがないと、このステップは`SIGNATURE_IDENTITY_NOT_VERIFIED`を記録します。
- コードをメールで送る場合（既定）は**メールアドレス認証**、SMSで送る場合は**電話番号検証**。コードは、同じセッションで検証済みの連絡先にのみ送信されます。
- ワークフローに**ライブネス検知**もある場合は、承認されている必要があります。署名済み書類のコピーを署名者にメールで送るには、コードをSMSで送る場合でも、セッションに検証済みのメールアドレスが必要です。**法人確認（KYB）の場合**、署名者は法人の主要関係者で、それぞれが承認済みの自身のKYCを持っています。| `signature_signer` | 署名者 |
| - | - |
| `legal_representative` | ロールが`representative`または`authorized_signatory`のすべての主要関係者 |
| `key_people` | KYCセッションを持つすべての個人の主要関係者 |KYBのステップには1〜20人の署名者がおり、各署名者は署名する時点で承認済みのKYCが必要です。各署名者は自分用の書類のコピーに署名し、自身のKYCセッションで検証された連絡先に届くコードで確定します。主要関係者として申告された氏名は、大文字小文字とスペースを無視して検証済みの氏名と一致する必要があり、一致しないとステップは`SIGNATURE_NAME_MISMATCH`を記録します。ステップは、すべての署名者が署名または辞退した時点で完了します。## 書類### 書類の取得元`signature_documents_source`は、ステップが書類をどこから取得するかを設定します。| 値 | 書類 |
| - | - |
| `workflow`（既定） | コンソールでワークフローにアップロードした書類。すべてのセッションが同じ書類に署名します。 |
| `session` | [セッションを作成](https://docs.didit.me/sessions-api/create-session.md#electronic-signature-documents)するときに`sign.documents`で送信する書類。セッションごとに別の書類に署名します。 |
| `both` | 先にワークフローの書類、次にセッションの書類。 |セッションごとの書類を使うと、氏名、金額、条件を御社のシステムであらかじめ入力した契約書に、本人が署名できます。### 対応ファイル| | 上限 |
| - | - |
| PDF | 1ファイルあたり最大20 MB、100ページ。パスワード、スクリプト、添付ファイルは不可。 |
| Word（`.docx`） | 最大20 MB。アップロード時またはセッション作成時にPDFに変換され、変換後のPDFにはPDFと同じ上限が適用されます。`.doc`、`.docm`、`.odt`、`.rtf`ファイルは`unsupported_type`で拒否されます。 |
| 署名者ごと | 合計で最大20書類、50 MB。 |Word文書をアップロードすると、Diditはアップロード中に最大60秒でPDFに変換します。署名者が見て署名するのは変換後のページなので、フィールドを配置する前に確認してください。改行位置がWordとわずかに異なる場合があります。WordファイルとそのPDFは同じ書類に属し、書類とともに削除されます。証拠PDFには、変換の記録と両ファイルのSHA-256が記載されます。署名対象が曖昧になる場合、DiditはWordファイルを`signature_document_not_supported`と`reason`で拒否します。マクロ（`macros`）、未承諾の変更履歴（`tracked_changes`）、外部コンテンツへのリンク（`external_links`）、埋め込みオブジェクト（`embedded_objects`）がある場合です。アップロード前に変更履歴を承諾または却下して、PDFに合意した文面が表示されるようにしてください。変換できないファイルは、`signature_document_conversion_failed`と次のいずれかの理由で拒否されます。| `reason` | 問題の内容 |
| - | - |
| `docx_password_protected` | ファイルにパスワードが設定されています。解除して再度アップロードしてください。 |
| `docx_unreadable` | ファイルが読み取り可能なWord文書ではありません。 |
| `docx_too_many_pages` | 変換後のPDFが100ページを超えています。 |
| `docx_too_large` | ファイルが大きすぎて変換できません。 |
| `conversion_timeout` | 変換に時間がかかりすぎました。再試行するか、書類をPDFとしてアップロードしてください。 |### 書類上のフィールドフィールドを使うと、デスクトップの署名ツールで封筒を準備するのと同じように、書類を署名者が入力するテンプレートにできます。フィールドのない書類では、署名者が読んで同意するだけの、より簡単なフローになります。| タイプ | 署名者の操作 | 値 |
| - | - | - |
| `signature` | タップして、採用した署名を適用します。最初の署名またはイニシャルのフィールドで、署名を採用するステップが開きます。 | 適用後は`true` |
| `initials` | タップして、採用したイニシャルを適用します。 | 適用後は`true` |
| `text` | 値を入力します。フィールドの[検証](#検証)でチェックされます。事前入力も可能です。 | 文字列 |
| `checkbox` | オン・オフを切り替えます。必須のチェックボックスはオンにする必要があります。 | ブール値 |
| `email` | セッションに検証済みのメールアドレスがある場合は操作不要で、読み取り専用で入力されます。それ以外は入力します。 | 文字列 |
| `full_name` | 操作不要です。Diditが検証済みの氏名を読み取り専用で入力します。 | 文字列 |
| `date_signed` | 操作不要です。Diditが書類に署名した日付を入力します。 | 文字列 |
| `data` | 操作不要です。Diditが検証済みの本人情報、セッション、または御社のシステムの値を、読み取り専用で入力します。値の取得元は`prefill`で設定します。 | 文字列 |このバージョンには日付ピッカーはありません。署名者が入力する日付には`text`フィールドを使ってください。フィールドには次のプロパティがあります。| プロパティ | ルール |
| - | - |
| `id` | Diditが設定します。 |
| `key` | 結果と`sign.field_values`でフィールドを指す名前。小文字、数字、アンダースコアで、文字で始まり、最大64文字（`^[a-z][a-z0-9_]{0,63}$`）、書類内で一意です。 |
| `type` | 上記のタイプのいずれか。 |
| `role` | 入力する人。`signature_signer`の値（`verified_person`、`legal_representative`、`key_people`）を使います。セッション書類では、既定はステップの署名者です。 |
| `page` | 1から書類のページ数まで。Word文書では、変換後のPDFのページです。 |
| `x`, `y`, `width`, `height` | 表示されたページに対する割合（`0`〜`1`）で、左上隅から測り、小数点以下4桁に丸めます。フィールドはページ内に収まる必要があります。幅は最小`0.02`、高さは最小`0.012`で、署名は最小`0.12`×`0.035`です。 |
| `required` | `signature`と`initials`は、`false`を設定しない限り必須です。`full_name`、`date_signed`、`data`は常に必須です。 |
| `label` | 1〜80文字。署名者と結果に表示されます。 |
| `placeholder` | `text`と`email`のみ。最大80文字。 |
| `position` | 署名者が案内される順序で、`0`から始まります。Diditがフィールドの位置から設定します。ページ順、上から下、左から右の順です。 |
| `validation` | `text`のみ。[検証](#検証)を参照してください。 |
| `prefill` | 値の取得元。[事前入力される値](#事前入力される値)を参照してください。 |
| `editable_when_prefilled` | `text`と`email`のみ。署名者が事前入力された値を変更できます。既定は`false`。 |
| `checked_by_default` | `checkbox`のみ。ボックスが最初からオンになります。 |
| `date_format` | `date_signed`のみ。`DD/MM/YYYY`（既定）、`MM/DD/YYYY`、`YYYY-MM-DD`、`D MMMM YYYY`。 |```json theme={null}
{
  "id": "6a2f1c0e-4d8b-4f5e-9a51-0c7b2e9d3f10",
  "key": "occupation",
  "type": "text",
  "role": "verified_person",
  "page": 1,
  "x": 0.34,
  "y": 0.4618,
  "width": 0.57,
  "height": 0.0325,
  "required": true,
  "label": "Occupation",
  "placeholder": "For example, nurse",
  "position": 5,
  "validation": { "kind": "any", "min_length": 0, "max_length": 80, "pattern": null, "message": null },
  "prefill": null,
  "editable_when_prefilled": false,
  "checked_by_default": false,
  "date_format": null
}
```1つの書類には最大200個のフィールドを設定でき、1人の署名者につき、その人の書類全体で最大500個まで設定できます。ステップが入力して刻印するのは、そのステップの署名者のフィールドだけです。1つの書類に複数のロールのフィールドを設定できるのは、ワークフローの複数の署名ステップがその書類を使う場合のみです。各ステップは自分のロールのフィールドを入力し、そのコピーでは他のロールのフィールドを空のままにします。ワークフローのどの署名ステップも使っていないロールのフィールドは、`role_not_used`で拒否されます。書類にフィールドがあるロールには、そこに`signature`または`initials`のフィールドが少なくとも1つ必要で、ないとワークフローのバージョンを公開できません（`signature_field_missing`）。#### 検証`validation`は`text`フィールドに適用されます。```json theme={null}
{ "kind": "any", "min_length": 0, "max_length": 80, "pattern": null, "message": null }
```- `kind`: `any`、`letters`（任意の文字体系の文字、スペース、ハイフン、アポストロフィ）、`number`（任意の小数点記号付きの数字）、`email`、または`pattern`。
- `min_length`: `0`から`max_length`まで。
- `max_length`: `1`から`500`まで。既定は`120`。
- `pattern`: `kind: "pattern"`では必須。値全体が一致する必要がある、最大200文字の正規表現。先読み・後読みと後方参照はサポートされません。
- `message`: 最大120文字。既定のエラーの代わりに表示されます。コンソールのプレビュー、署名フロー、APIには同じルールが適用されます。#### 事前入力される値`prefill`は、フィールドの値の取得元を指定します。| `prefill` | 値 |
| - | - |
| `identity.full_name`, `identity.first_name`, `identity.last_name` | 署名者の検証済みIDに記載された氏名。 |
| `identity.date_of_birth` | 検証済みIDから取得し、`DD/MM/YYYY`形式。 |
| `identity.nationality`, `identity.document_number`, `identity.document_type`, `identity.issuing_country` | 検証済みIDから取得。 |
| `identity.address` | 検証済みIDから、または同じセッションの住所証明から取得した、整形済みの住所。 |
| `contact.email`, `contact.phone` | 署名者の検証済みのメールアドレスまたは電話番号。 |
| `company.name`, `company.registration_number`, `company.address`, `company.country` | KYBの場合の、検証済みの法人。 |
| `session.vendor_data` | セッションの`vendor_data`。 |
| `metadata.<key>` | セッションの`metadata`にある`<key>`の値（文字列）。 |
| `api.<key>` | [セッションを作成](https://docs.didit.me/sessions-api/create-session.md#field-values)するときに送信した`sign.field_values`にある`<key>`の値。 |`data`フィールドには`prefill`が必須です。`full_name`フィールドは常に`identity.full_name`を、`email`フィールドは`contact.email`を使い、`text`フィールドにも設定できます。`data`、`full_name`、検証済み`email`の各フィールドの値は、署名者が署名を開始した時点で固定され、その後にセッションを変更しても変わりません。事前入力された`text`または`email`フィールドは、`editable_when_prefilled`を設定しない限り読み取り専用です。必須フィールドの取得元に、その時点で値がない場合（例えば住所のないセッション）、フィールドは空のまま表示されません。ステップは[`SIGNATURE_FIELD_DATA_MISSING`](https://docs.didit.me/core-technology/electronic-signature/warnings-electronic-signature)を発生させ、`signature_field_data_missing_action`（既定は`REVIEW`）を適用します。`NO_ACTION`の場合、署名者は署名でき、フィールドは空のままになります。## コンソールで設定する1) **ワークフロー**に移動してワークフローを開き、署名者を検証するステップの後に**電子署名**ステップを追加します。
2) **書類**で**アップロード**を選択してPDFまたはWordファイルを追加し、署名者に表示される順にドラッグして並べます。WordファイルはPDFに変換されるため、フィールドを配置する前に変換後のページを確認してください。**置き換え**は、書類のファイルを差し替え、新しいファイルにないページ上のフィールドを除いて、フィールドを保持します。
3) **書類にフィールドを配置**で、**エディターを開く**を選択します。パレットからフィールドをページにドラッグするか、フィールドを選択して配置したい場所をクリックし、移動とサイズ変更をします。各フィールドについて、**入力する人**、ラベル、**必須**かどうか、受け付ける内容、値の取得元、**API キー**（フィールドの`key`）を設定します。**署名者としてプレビュー**では、署名者がスマートフォンまたはデスクトップで見る書類の表示を確認できます。エディターは操作のたびに保存され（**ドラフトに保存済み**）、**完了**を選択する前に修正すべき項目が一覧表示されます。
4) 引き続き**書類**で、書類の取得元として**このワークフロー**、**各セッション**、**両方**のいずれかを選びます。フィールドのない書類では、署名者が**署名前に最後まで読む**必要があるかどうかを選び、**書類ごとの同意**を設定します。
5) **署名**で、**署名者**、**レベル**（**高度（AES）**）、**形式**、コードの送信先（**ワンタイムコードの送信方法**）を選びます。
6) **ルール**で、各[警告](https://docs.didit.me/core-technology/electronic-signature/warnings-electronic-signature.md)が判定に与える影響を設定します。
7) **高度**で、**署名済みコピーをメール送信**するか、**証拠ページを追加**するか、署名リンクが有効な日数を選びます。カスタムのステータスルールも追加できます。
8) ワークフローを保存します。APIで同じステップを設定するには、[ワークフローの機能設定](https://docs.didit.me/management-api/workflows/feature-configs.md#electronic-signature)を参照してください。ワークフローの書類とそのフィールドはコンソールで管理し、APIではセッションごとに書類とフィールドを送信します。## 署名の体験署名ステップは、ホスト型の検証ページ、[Web SDK](https://docs.didit.me/ja/integration/web-sdks/overview.md)、[ネイティブSDK](https://docs.didit.me/ja/integration/native-sdks/overview.md)で、デスクトップでもスマートフォンでも実行されます。署名用のUIを構築する必要はありません。1) **イントロ。** 署名者は、署名する書類を確認します。
2) **各書類を順番に。** フィールドのある書類では、署名者は`position`の順にフィールドを案内されます。最初の署名またはイニシャルのフィールドで、[署名を採用する](#署名の採用)シートが開きます。任意のフィールドには**任意**と表示されます。Diditが入力した値はロックアイコン付きでページに表示され、操作は不要です。ページ上のフィールドをタップすると、そのフィールドに移動します。スマートフォンでは、キーボードの上に固定されたパネルに、1つずつフィールドが表示されます。幅1200 px以上の画面では、ページがフィールドの一覧の横に表示されます。必須フィールドが空のまま書類を終えようとすると、残りの数が表示され、最初のフィールドに移動します。フィールドのない書類は、設定どおりに読んで同意します。
3) **確認。** 署名者は書類をもう一度確認し、いずれかにフィールドがある場合は、電子的に署名することに同意します。
4) **コード。** 署名者がコードを要求します。コードは5分間有効で、60秒後に新しいコードを送信でき、署名者は最大5回のコード送信と3回の入力ミスまで可能です。上限に達すると`SIGNATURE_OTP_FAILED`が記録されます。
5) **署名済み。** 署名後、署名者は署名済みの書類をダウンロードできます。有効にしている場合は、Diditがコピーをメールで送信します。
6) **辞退。** 署名者は、署名する代わりに辞退できます。この場合`SIGNATURE_DECLINED`が記録されます。辞退は署名リンクが有効な間は再開できるため、署名者が考えを変えれば署名できます。フローは、コードの期限切れ、書類の変更、署名の失敗、署名リンクの期限切れを署名者に通知します。署名リンクは`signature_link_validity_days`（1〜30、既定は7）の間、セッション作成時から数えて有効です。セッションは少なくともその期間は開いたままです。> [!NOTE]
>
> ネイティブSDKでは、署名ステップが追加されたリリース以降で署名ステップが表示されます。リリースが公開されたら、[ネイティブSDKの概要](https://docs.didit.me/ja/integration/native-sdks/overview.md)に記載されます。フィールド付きの書類には、フィールドに対応したリリースが必要です。古いリリースでは表示できず、ステップにエラーが表示されます。フィールドのない書類は、署名ステップのあるすべてのリリースで動作します。アプリがワークフローで使う機能に対応したリリースで動作するまでは、ホスト型ページまたはWeb SDKへ誘導してください。### 署名の採用署名者は、書類が初めて署名またはイニシャルを求めた時点で、1つのシートで署名とイニシャルを一度だけ採用します。- **入力**: 検証済みの氏名を、選んだ筆記体スタイルで表示し、**From your ID**と表示されます。別の氏名は入力できません。入力のイニシャルは、その氏名の頭文字です。
- **手書き**: 指またはマウスで、署名とイニシャルの両方を手書きします。以降の署名またはイニシャルのフィールドは1回のタップで適用され、適用済みのフィールドをタップすると取り消されます。## 結果各署名者の結果は、[セッションの判定結果](https://docs.didit.me/sessions-api/retrieve-session.md)と[セッションWebhook](https://docs.didit.me/integration/webhooks.md)の`decision`にある`signatures[]`の項目です。署名専用のWebhookはありません。判定結果を取得するタイミングは、セッションの`status.updated`イベントで分かります。すべての書類の署名済みPDF、署名者ごとの証拠PDF、すべての元ファイルと署名済みファイルのSHA-256が提供されるため、後から何も変更されていないことを証明できます。フィールド付きの書類では、すべてのフィールドの値、その取得元、入力された時刻に加え、採用された署名と、署名者が電子的な署名に同意した時刻も得られます。すべてのフィールド、ダウンロード、署名の再検証方法については、[電子署名レポート](https://docs.didit.me/core-technology/electronic-signature/report-electronic-signature.md)を参照してください。コンソールでは、セッションの**署名**タブに書類が表示され、続いて**Fields**ブロックに、各ページのプレビュー、採用された署名とイニシャル、すべてのフィールドの値、時刻、取得元が表示されます。[PDFレポート](https://docs.didit.me/sessions-api/generate-pdf.md)には署名セクションが含まれ、書類にフィールドがある場合は**Electronic signature · fields**ページも含まれます。## 料金電子署名は、書類、署名者、署名ステップの数にかかわらず、署名済みセッションごとに1回課金されます。辞退、失敗、期限切れになった署名は課金されません。## 署名データの削除[セッションを削除](https://docs.didit.me/sessions-api/delete-session.md)すると、その署名データも一緒に削除されます。セッションとともに送信された書類とWordの元ファイル、署名者ごとに準備されたコピー、署名済みPDF、証拠PDF、採用された署名とイニシャルの画像、すべてのフィールド値が対象です。ダウンロードリンクは使えなくなります。データ保持期間の終了時にセッションが削除される場合も同様です。削除は元に戻せないため、保管が必要なものは先にダウンロードしてください。- 法人確認の署名済み書類は、法人のセッションに属します。そのセッションを削除すると、書類も削除されます。
- ワークフローから書類を削除すると、そのフィールドとWordの元ファイルとともに削除されます。すでに署名を開始した署名者は、セッションの一部として、表示されたコピーを、そのセッションを削除するまで保持します。署名待ちのセッションがないワークフローでのみ、書類を削除してください。
- Diditがすでに署名者にメールで送信したコピーは、署名者のメールボックスにあり、影響を受けません。## 関連ページ- [電子署名レポート](https://docs.didit.me/core-technology/electronic-signature/report-electronic-signature.md): `signatures[]`、署名済みPDF、証拠PDF、ダウンロード。
- [電子署名の警告](https://docs.didit.me/core-technology/electronic-signature/warnings-electronic-signature.md): すべての警告と、それを制御するルール。
- [セッションの作成](https://docs.didit.me/sessions-api/create-session.md#electronic-signature-documents): セッションごとに書類、フィールド、フィールド値を送信します。
- [ワークフローの機能設定](https://docs.didit.me/management-api/workflows/feature-configs.md#electronic-signature): ステップのすべての設定。


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