전자 서명 보고서: signatures[] 레퍼런스

모든 전자 서명 단계는 서명자당 하나의 결과를 생성합니다. 이는 다음 위치에서 signatures[]의 항목으로 확인할 수 있습니다.

사용자 인증(KYC) 및 기업 확인(KYB) 세션의 경우 GET /v3/session/{sessionId}/decision/.
세션이 Approved, Declined, In Review 또는 Abandoned 상태일 때 전송되는 V3 세션 webhook의 decision.
콘솔의 세션 서명 탭 및 PDF 보고서의 서명 섹션.

signatures는 워크플로에 전자 서명 단계가 포함되어 있을 때만 decision에 포함됩니다. 서명자가 해당 단계에 도달할 때까지는 빈 배열입니다. KYC 단계에는 항목이 하나 포함되며, KYB 단계에는 서명자당 항목이 하나씩 포함됩니다.

예시

{
  "signatures": [
    {
      "id": "0e6c2a8e-6c2f-4b8e-9a51-3f2f6a7d9b10",
      "node_id": "feature_signature",
      "status": "signed",
      "verdict": "Approved",
      "level": "aes",
      "format": "pades",
      "profile": "PAdES-B-LT",
      "signer": {
        "name": "Jane Doe",
        "capacity": "self",
        "company": null,
        "role": null,
        "roles": [],
        "identity_session_id": "11111111-2222-3333-4444-555555555555"
      },
      "identity_used": {
        "session_id": "11111111-2222-3333-4444-555555555555",
        "kyc_id": "6f1e8f6c-1d2b-4c3a-9e8f-7a6b5c4d3e2f",
        "verified": true,
        "expected_name": "Jane Doe"
      },
      "certificate": {
        "issuer": "<certificate issuer>",
        "issued_to": "<certificate subject>",
        "serial": "5A3F9C21",
        "valid_from": "2026-01-01T00:00:00+00:00",
        "valid_until": "2028-01-01T00:00:00+00:00"
      },
      "confirmation": {
        "channel": "email",
        "destination": "j***@example.com",
        "confirmed_at": "2026-11-03T10:42:18.512Z",
        "attempts": 1
      },
      "timestamp": {
        "time": "2026-11-03T10:42:21+00:00",
        "qualified": false,
        "valid": true
      },
      "documents": [
        {
          "id": "9b0a7f44-2c1d-4e5f-8a9b-0c1d2e3f4a5b",
          "uuid": "9b0a7f44-2c1d-4e5f-8a9b-0c1d2e3f4a5b",
          "title": "Account agreement",
          "file_name": "agreement.pdf",
          "pages": 4,
          "size_bytes": 182344,
          "sha256_original": "3b8e5f0c2a9d4e7f1b6c0a5d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f",
          "sha256_signed": "a1f2e3d4c5b6a7980f1e2d3c4b5a69788f7e6d5c4b3a29180f1e2d3c4b5a6978",
          "status": "signed",
          "opened_at": "2026-11-03T10:40:02.118Z",
          "read_at": "2026-11-03T10:41:10.044Z",
          "read_to_end": true,
          "consented_at": "2026-11-03T10:41:12.730Z",
          "consent": true,
          "signed_file": "/v3/session/11111111-2222-3333-4444-555555555555/signatures/feature_signature/documents/9b0a7f44-2c1d-4e5f-8a9b-0c1d2e3f4a5b/file/",
          "mode": "fields",
          "source_format": "pdf",
          "conversion": null,
          "fields": [
            {
              "key": "full_name",
              "type": "full_name",
              "role": "verified_person",
              "label": "Full name",
              "page": 1,
              "x": 0.34,
              "y": 0.2326,
              "width": 0.57,
              "height": 0.0325,
              "required": true,
              "value": "Jane Doe",
              "display_value": "Jane Doe",
              "value_source": "identity",
              "filled_at": "2026-11-03T10:40:02.118Z",
              "value_unavailable_reason": null
            },
            {
              "key": "occupation",
              "type": "text",
              "role": "verified_person",
              "label": "Occupation",
              "page": 1,
              "x": 0.34,
              "y": 0.4618,
              "width": 0.57,
              "height": 0.0325,
              "required": true,
              "value": "Architect",
              "display_value": "Architect",
              "value_source": "signer",
              "filled_at": "2026-11-03T10:40:41.502Z",
              "value_unavailable_reason": null
            },
            {
              "key": "signature",
              "type": "signature",
              "role": "verified_person",
              "label": "Signature",
              "page": 4,
              "x": 0.09,
              "y": 0.5303,
              "width": 0.36,
              "height": 0.0849,
              "required": true,
              "value": true,
              "display_value": "Signed",
              "value_source": "signer",
              "filled_at": "2026-11-03T10:41:05.200Z",
              "image_url": "/v3/session/11111111-2222-3333-4444-555555555555/signatures/feature_signature/fields/c4d5e6f7-0a1b-4c2d-8e3f-4a5b6c7d8e9f/image/",
              "value_unavailable_reason": null
            }
          ]
        }
      ],
      "adopted_signature": {
        "method": "drawn",
        "font": null,
        "adopted_at": "2026-11-03T10:41:02.871Z"
      },
      "electronic_signature_consent_at": "2026-11-03T10:41:40.016Z",
      "evidence_file": "/v3/session/11111111-2222-3333-4444-555555555555/signatures/feature_signature/evidence/?signature_id=0e6c2a8e-6c2f-4b8e-9a51-3f2f6a7d9b10",
      "warnings": [],
      "validation": {
        "valid": true,
        "checked_at": "2026-11-03T10:42:24.903Z",
        "documents": [
          {
            "id": "9b0a7f44-2c1d-4e5f-8a9b-0c1d2e3f4a5b",
            "checked_at": "2026-11-03T10:42:24.903Z",
            "valid": true,
            "integrity": true,
            "trusted": true,
            "revoked": false,
            "trusted_list": { "status": "not_applicable", "reason": "aes_not_qualified" },
            "certificate": {
              "issuer": "<certificate issuer>",
              "issued_to": "<certificate subject>",
              "serial": "5A3F9C21",
              "valid_from": "2026-01-01T00:00:00+00:00",
              "valid_until": "2028-01-01T00:00:00+00:00"
            },
            "timestamp": { "time": "2026-11-03T10:42:21+00:00", "qualified": false, "valid": true }
          }
        ]
      },
      "declined_at": null,
      "declined_action": "REVIEW",
      "signed_at": "2026-11-03T10:42:24.903Z",
      "expires_at": "2026-11-10T10:30:00.000Z",
      "email_sent_at": "2026-11-03T10:42:30.011Z",
      "email_unavailable_reason": null,
      "ip_address": "203.0.113.10",
      "place": null,
      "place_unavailable_reason": "not_collected"
    }
  ]
}

서명 객체

필드	타입	설명
`id`	string (UUID)	서명자의 서명입니다. 증거 문서를 다운로드하거나 서명을 검증할 때 `signature_id`로 전달합니다.
`node_id`	string	이를 생성한 워크플로 단계입니다.
`status`	string	단계 내에서 서명자의 진행 상태: `intro`, `review`, `code`, `signing`, `signed` 또는 `declined`. `signed`만 문서가 서명되었음을 의미합니다.
`verdict`	string	해당 단계의 결과: `Not Finished`, `Approved`, `In Review` 또는 `Declined`. 거절되거나 실패한 서명은 해당 규칙의 결정을 따르며, 커스텀 상태 규칙으로 변경될 수 있습니다.
`level`	string	`simple`(기본값) 또는 `aes`. `qes`는 아직 제공되지 않는 추가 기능입니다.
`format`	string	단순(Simple) 서명의 경우 `pdf`, 고급(AES) 서명의 경우 `pades`입니다.
`profile`	string \| null	고급(AES) 서명이 완료되면 `PAdES-B-LT`, 그렇지 않으면 `null`입니다.
`signer`	object	서명한 사람입니다. 서명자를 참조하십시오.
`identity_used`	object	서명이 의존하는 검증된 신원입니다. 서명자를 참조하십시오. 검증된 신원이 없는 단순 서명의 경우 비어 있습니다.
`certificate`	object \| null	문서 서명에 사용된 인증서: `issuer`, `issued_to`, `serial`, `valid_from` 및 `valid_until`. 서명 전까지는 `null`이며, 단순 서명인 경우 항상 `null`입니다.
`confirmation`	object	일회용 코드: `channel`(`email` 또는 `sms`), `destination`(코드가 전송된 마스킹된 연락처), `confirmed_at`, `attempts`(올바른 코드를 포함하여 입력된 코드 횟수). 단순 서명에는 코드가 없으므로 `channel` 및 `destination`은 `null`입니다.
`timestamp`	object \| null	서명에 포함된 Didit 발급 RFC 3161 타임스탬프: `time`, `qualified`(AES의 경우 항상 `false`), `valid`. 서명 전까지는 `null`이며, 단순 서명인 경우 항상 `null`입니다.
`documents`	array	문서당 하나의 항목입니다. 문서를 참조하십시오.
`adopted_signature`	object \| null	서명자가 서명 및 이니셜 필드에 적용한 서명 및 이니셜: `method`(`typed` 또는 `drawn`), `font`(입력형 서명의 필체 스타일, 그린 서명인 경우 `null`), `adopted_at`. 서명자가 적용하기 전까지는 `null`입니다.
`electronic_signature_consent_at`	string \| null	서명자가 검토 화면에서 문서 전자 서명에 동의한 시점입니다. 문서에 필드가 하나라도 있을 때 설정됩니다.
`evidence_file`	string \| null	서명이 완료된 후 이 서명자의 증거 PDF 경로입니다.
`warnings`	array	발생한 각 경고에 대한 `{ "code", "node_id" }` 항목입니다.
`validation`	object \| null	서명된 문서의 최근 암호학적 검사입니다. 서명 다시 검증을 참조하십시오.
`declined_at`	string \| null	서명자가 거절한 시점입니다.
`declined_action`	string	해당 단계의 `signature_declined_action`: 거절 시 결정에 미치는 영향입니다.
`signed_at`	string \| null	문서가 서명된 시점입니다.
`expires_at`	string	서명 링크가 만료되는 시점입니다.
`email_sent_at`	string \| null	Didit이 서명자에게 서명된 사본을 이메일로 전송한 시점입니다.
`email_unavailable_reason`	string \| null	사본 전송을 요청했으나 이메일이 전송되지 않은 이유입니다.
`ip_address`	string \| null	서명자가 코드를 요청했을 때의 주소입니다.
`place`	string \| null	수집되지 않습니다. 항상 `null`이며 `place_unavailable_reason: "not_collected"`가 함께 제공됩니다.

status가 signed가 될 때까지는 서명자가 서명한 것으로 간주해서는 안 됩니다. 고급(AES) 서명에서 null 인증서, 타임스탬프 또는 signed_file은 아직 서명이 완료되지 않았음을 의미합니다. 서명된 단순 서명에는 signed_file이 있지만 인증서와 타임스탬프는 항상 null입니다.

서명자

필드	설명
`signer.name`	승인된 신분증 인증에서 가져온 서명자의 검증된 성명입니다. 단순 서명 등급에서는 검증된 세션 성명이 있을 경우 해당 성명이며, 그렇지 않으면 서명자가 직접 입력한 검증되지 않은 성명입니다.
`signer.capacity`	개인이 본인을 위해 서명하는 경우(KYC) `self`, 주요 인물이 기업을 위해 서명하는 경우(KYB) `company`입니다.
`signer.company`	KYB의 경우 기업의 이름입니다.
`signer.role`	KYB의 경우 신고된 주요 인물의 직함입니다.
`signer.roles`	서명 자격을 부여한 주요 인물의 구조화된 역할(예: `representative` 또는 `authorized_signatory`)입니다. 이는 법인 등기부 확인이 아닌 해당 기업에 대해 신고된 역할입니다.
`signer.identity_session_id`	서명자를 검증한 KYC 세션입니다. KYB의 경우 주요 인물 본인의 KYC 세션입니다. 검증된 신원이 없는 단순 서명의 경우 생략됩니다.
`identity_used.session_id`	`signer.identity_session_id`와 동일합니다. 검증된 신원이 없는 단순 서명의 경우 `identity_used`가 비어 있으므로 해당 필드가 나타나지 않습니다.
`identity_used.kyc_id`	성명을 가져온 신분증 인증입니다.
`identity_used.verified`	해당 신분증 인증이 승인되었으면 `true`입니다.
`identity_used.expected_name`	서명자가 일치해야 했던 성명입니다. KYB의 경우 주요 인물에 대해 신고된 성명입니다.

문서

필드	설명
`id`, `uuid`	문서 식별자입니다. 서명된 파일을 다운로드할 때 사용합니다.
`title`, `file_name`	업로드되었거나 전송된 그대로의 값입니다.
`pages`, `size_bytes`	서명자가 서명한 문서의 크기 및 페이지 수입니다. Word 문서의 경우 변환된 PDF 기준입니다.
`sha256_original`	서명자에게 표시된 원본 문서의 SHA-256 값입니다.
`sha256_signed`	서명이 완료된 후 서명된 PDF의 SHA-256 값입니다.
`status`	`signed`, `declined`, `not_signed`(열람했으나 서명하지 않음), 또는 `not_reached`(한 번도 열람하지 않음)입니다.
`opened_at`	서명자가 문서를 처음 열람한 시점입니다.
`read_at`, `read_to_end`	필드가 없는 문서를 끝까지 읽도록 요구한 경우, 서명자가 문서 끝에 도달한 시점입니다. 필드가 있는 문서에는 필요하지 않습니다.
`consented_at`, `consent`	문서별 동의를 요구한 경우 필드가 없는 문서에 서명자가 동의했거나, 필드가 있는 문서의 필드 입력을 완료한 시점입니다.
`signed_file`	서명이 완료된 후 서명된 PDF의 경로입니다.
`mode`	필드가 있는 문서는 `fields`, 필드가 없는 문서는 `read_and_agree`입니다.
`source_format`	`pdf`, 또는 Didit이 변환한 Word 문서의 경우 `docx`입니다.
`conversion`	PDF의 경우 `null`입니다. Word 문서의 경우 `{ "from": "docx", "file_name", "sha256", "size_bytes", "converter" }`로, 원본 파일, 해당 파일의 SHA-256 및 크기, 변환기 버전이 포함됩니다.
`fields`	문서의 필드와 해당 값입니다. 필드가 없는 문서의 경우 비어 있습니다.

필드

documents[].fields[]의 각 항목은 해당 서명자의 사본에 값과 함께 표시되는 문서 필드 하나를 나타냅니다:

필드	설명
`key`	필드의 키로, `sign.field_values`에서 사용하는 것과 동일합니다.
`type`, `role`, `label`, `required`	문서에 배치된 상태 그대로입니다.
`page`, `x`, `y`, `width`, `height`	표시된 페이지에서의 비율로 나타낸 필드 위치입니다.
`value`	`text`, `email`, `full_name`, `date_signed`, `data` 필드의 경우 문자열, 체크박스의 경우 불리언, 적용된 서명 또는 이니셜의 경우 `true`입니다. 필드가 비어 있으면 `null`입니다.
`display_value`	페이지에 날인된 형태의 값: 필드의 `date_format` 형식으로 표시된 날짜, 체크박스의 경우 `Yes` 또는 `No`, 서명 또는 이니셜의 경우 `Signed`입니다.
`value_source`	값의 출처: `signer`(서명자가 입력, 체크 또는 적용), `identity`(검증된 신분증), `contact`(인증된 이메일 또는 전화번호), `company`(확인된 기업), `session`(세션의 `vendor_data`), `metadata`(세션의 `metadata`), `api`(귀사의 `sign.field_values`), `signing_time`(서명 날짜)입니다.
`filled_at`	값이 설정된 시점입니다.
`image_url`	서명 또는 이니셜의 경우, 적용된 이미지(PNG)의 경로입니다. 서명 이미지 다운로드를 참고하십시오.
`value_unavailable_reason`	Didit이 채우는 필드에 값이 없는 이유: `not_verified`(신원 또는 연락처가 인증되지 않음), `not_applicable`(개인의 서명에 있는 기업 필드), `not_provided`(출처에 값이 없음), `set_at_confirmation`(서명자가 확인하기 전의 서명 날짜)입니다. 그 외의 경우에는 `null`입니다.

서명된 문서 다운로드

API 키와 함께 signed_file 및 evidence_file의 경로를 사용하십시오. 각 경로는 PDF 자체를 응답으로 반환합니다.

# Signed PDF of one document
curl -L 'https://verification.didit.me/v3/session/{session_id}/signatures/{node_id}/documents/{document_id}/file/' \
  -H 'x-api-key: YOUR_API_KEY' \
  -o agreement-signed.pdf

# Evidence PDF of one signer
curl -L 'https://verification.didit.me/v3/session/{session_id}/signatures/{node_id}/evidence/?signature_id={signature_id}' \
  -H 'x-api-key: YOUR_API_KEY' \
  -o signature-evidence.pdf

경로	레퍼런스
`GET .../documents/{document_id}/file/`	서명된 문서 다운로드
`GET .../evidence/`	서명 증빙 다운로드
`GET .../fields/{field_id}/image/`	서명 이미지 다운로드
`POST .../validate/`	서명 검증

응답하기 전에 Didit은 저장된 파일을 기록된 SHA-256과 대조하여 확인합니다. 일치하지 않는 경우, 서명된 PDF 및 증빙 경로는 409를 반환하고 이미지 경로는 400을 반환하며, 각각 signature_document_changed가 포함됩니다. KYB 단계에 서명자가 여러 명 있는 경우 증빙 경로에 항상 signature_id를 전달하십시오.

서명된 PDF

서명된 PDF에는 다음 내용이 순서대로 포함됩니다.

서명자에게 표시된 문서의 페이지(배치한 위치에 각 필드 값이 날인됨).
증빙 페이지(signature_evidence_page를 비활성화하지 않은 경우).
고급(AES)에 한해, Didit이 발행한 RFC 3161 타임스탬프 및 향후 검증에 필요한 인증서 폐지 데이터가 포함된 PAdES 서명. 일반(Simple) PDF는 증빙 페이지 이후 종료되며 디지털 서명, 직인 또는 타임스탬프가 없습니다.

고급(AES) PDF에서 서명은 필드 값과 증빙 페이지를 포함하여 서명 이전의 모든 바이트에 적용됩니다. 이후 파일의 어떤 부분이라도 변경하면 서명이 무효화되며, PAdES를 지원하는 모든 검증기에서 이를 확인할 수 있습니다. 서명의 세부 정보에는 서명자의 이름이 명시되고, 검증된 신원 세션 및 코드 확인이 참조됩니다. 필드 값은 폼 필드가 아닌 페이지 콘텐츠의 일부가 되므로 나중에 편집할 수 없으며 모든 PDF 뷰어에 표시됩니다. 선택된 체크박스에는 체크 표시가 나타나고, 선택되지 않은 체크박스는 문서에 그려진 그대로 유지됩니다. 24포인트보다 높은 서명 상자에는 서명 아래에 Signed with Didit · 뒤에 서명의 id 처음 8자가 붙은 작은 캡션도 추가됩니다. Didit은 서명자에게 표시된 문서의 바이트 뒤에 필드 값, 증빙 페이지 및 서명을 추가합니다. 해당 문서는 서명된 파일의 정확한 접두사이므로, 서명된 PDF에 대해서도 sha256_original을 계속 확인할 수 있습니다.

증빙 PDF

증빙 PDF는 단일 서명자에 대해 다음 항목을 기록합니다.

수준 및 형식.
서명자 이름, 서명 자격 및 KYB의 경우 기업.
검증된 신원 세션(고급(AES) 전용).
확인 내역: 채널, 마스킹된 대상 및 시간(고급(AES) 전용).
서명자의 IP 주소.
각 문서: 제목, 페이지 수 및 원본의 SHA-256. Word 문서의 경우 Word 파일의 이름과 SHA-256, 변환기 버전 및 PDF의 SHA-256.
채택된 서명: 텍스트 입력(필기체 스타일 포함) 또는 직접 서명, 채택된 시점, 서명 및 이니셜 이미지.
문서별 각 필드: 레이블, 페이지 및 유형, 해당 값(서명 또는 이니셜의 경우 이미지), 값의 출처(예: 서명자가 입력함, 검증된 신분증 또는 귀사 API), 입력된 시간(UTC) 및 서명자가 직접 입력한 값의 경우 해당 시점의 서명자 IP 주소.
최종 동의: 검토 화면에서 서명자가 동의한 문구 및 동의 시점.
서명된 각 파일의 SHA-256 및 고급(AES)의 경우 인증서(발급 대상, 발급자, 일련번호 및 유효 기간)와 타임스탬프.

서명된 각 PDF 뒤에 추가되는 페이지는 서명이 적용되기 전에 추가되므로 인증서 섹션을 제외하고 동일한 내용을 포함합니다.

서명 다시 검증하기

POST /v3/session/{session_id}/signatures/{node_id}/validate/는 해당 단계의 모든 서명된 PDF를 다시 읽고 해당 SHA-256을 확인합니다. 고급 전자 서명(AES)의 경우 PAdES 서명, 인증서, 해지 데이터 및 타임스탬프도 검증합니다. 일반 서명에는 디지털 서명이 없으므로 파일의 무결성만 확인합니다. 검증 결과는 validation에 저장되고 업데이트된 signatures[]가 반환됩니다. 서명자 한 명만 확인하려면 signature_id를 전송하십시오. 이 작업에는 write:sessions 권한이 필요하며, 콘솔에서는 다시 검증 버튼에 해당합니다. 저장된 서명 PDF가 해당 sha256_signed와 더 이상 일치하지 않으면 signature_document_changed와 함께 400이 반환됩니다. 문서에 서명이 완료될 때까지 validation은 null입니다. Didit이 서명 결과를 확인할 수 없는 경우 validation은 { "valid": null, "reason": "signature_provider_outcome_unknown", "checked_at" }가 되고 문제가 해결될 때까지 status는 signing으로 유지됩니다. 이는 서명되지 않은 것으로 처리하십시오.

`validation.documents[]`의 필드	설명
`valid`	서명과 타임스탬프가 모두 유효하고 신뢰할 수 있는 경우 `true`입니다. 일반 서명의 경우 파일이 변경되지 않았으면 `true`입니다.
`integrity`	서명 후 문서가 변경되지 않은 경우 `true`입니다.
`trusted`	서명 인증서가 신뢰할 수 있는 루트로 체인 연결되는 경우 `true`입니다. 일반 서명의 경우 `null`입니다.
`revoked`	서명 인증서가 해지된 경우 `true`입니다. 일반 서명의 경우 `null`입니다.
`trusted_list`	AES의 경우 `{ "status": "not_applicable", "reason": "aes_not_qualified" }`입니다. EU 신뢰 목록 검사는 적격 전자 서명에 적용됩니다. 일반 서명은 `{ "status": "not_applicable", "reason": "simple_not_sealed" }`를 반환합니다.
`certificate`, `timestamp`	파일에서 확인된 내용 그대로 표시됩니다.

PDF 보고서에서

PDF 보고서에는 서명자, 확인 내용, 인증서, 타임스탬프, 해시가 포함된 문서 정보가 담긴 서명 섹션이 인쇄됩니다. 문서에 필드가 포함된 경우 문서당 하나의 테이블이 포함된 전자 서명 · 필드 페이지가 이어지며, 모든 필드의 값, 서명 및 이니셜 이미지, 시간, 출처가 표시됩니다. 서명 섹션은 KYC 보고서에서는 은행 인증 뒤에, KYB 보고서에서는 문서 섹션 뒤에 위치합니다. 해당 섹션만 인쇄하려면 pages=signature를 전달하십시오.

인증

인증

모니터링

플랫폼

전자 서명 보고서: signatures[] 레퍼런스

예시

서명 객체

서명자

문서

필드

서명된 문서 다운로드

서명된 PDF

증빙 PDF

서명 다시 검증하기

PDF 보고서에서

관련 항목

​예시

​서명 객체

​서명자

​문서

​필드

​서명된 문서 다운로드

​서명된 PDF

​증빙 PDF

​서명 다시 검증하기

​PDF 보고서에서

​관련 항목

예시

서명 객체

서명자

문서

필드

서명된 문서 다운로드

서명된 PDF

증빙 PDF

서명 다시 검증하기

PDF 보고서에서

관련 항목