Zum Hauptinhalt springen
Jeder E-Signatur-Schritt erzeugt ein Ergebnis pro Unterzeichner. Sie finden es als Element von signatures[] in:
  • GET /v3/session/{sessionId}/decision/, für Sitzungen der Benutzerverifizierung (KYC) und Unternehmensverifizierung (KYB).
  • Dem decision-Feld der V3-Sitzungs-Webhooks, die gesendet werden, wenn die Sitzung Approved, Declined, In Review oder Abandoned ist.
  • Dem Tab Signatur der Sitzung in der Konsole sowie im Signaturbereich des PDF-Berichts.
signatures ist nur dann in der Entscheidung enthalten, wenn der Workflow einen E-Signatur-Schritt umfasst. Es ist ein leeres Array, bis ein Unterzeichner den Schritt erreicht. Ein KYC-Schritt enthält ein Element; ein KYB-Schritt enthält ein Element pro Unterzeichner.

Beispiel

Das Signatur-Objekt

Betrachten Sie einen Unterzeichner niemals als jemand, der unterschrieben hat, bevor status den Wert signed hat. Bei einer fortgeschrittenen Signatur (AES) bedeutet ein Zertifikat, Zeitstempel oder signed_file mit dem Wert null, dass noch keine Signatur vorliegt. Eine signierte einfache Signatur hat ein signed_file, aber immer ein Zertifikat und einen Zeitstempel mit dem Wert null.

Unterzeichner

Dokumente

Felder

Jedes Element von documents[].fields[] ist ein Feld des Dokuments mit seinem Wert auf der Kopie für diesen Unterzeichner:

Signierte Dokumente herunterladen

Verwenden Sie die Pfade in signed_file und evidence_file mit Ihrem API-Schlüssel. Jede Route liefert das PDF selbst.
Vor der Beantwortung vergleicht Didit die gespeicherte Datei mit ihrem erfassten SHA-256. Wenn sie voneinander abweichen, geben die Routen für signierte PDFs und Nachweise 409 und die Bild-Route 400 zurück, jeweils mit signature_document_changed. Übergeben Sie an die Nachweis-Route immer signature_id, wenn ein KYB-Schritt mehrere Unterzeichner hat.

Das signierte PDF

Das signierte PDF enthält der Reihe nach:
  1. Die Seiten des Dokuments, die dem Unterzeichner angezeigt wurden, wobei jeder Feldwert an der von Ihnen platzierten Stelle eingestempelt ist.
  2. Die Nachweisseite, es sei denn, Sie haben signature_evidence_page deaktiviert.
  3. Nur bei Advanced (AES) die PAdES-Signatur mit dem von Didit ausgestellten RFC-3161-Zeitstempel und den Widerrufsdaten, die für eine spätere Validierung erforderlich sind. Ein Simple-PDF endet nach der Nachweisseite und enthält keine digitale Signatur, kein Siegel und keinen Zeitstempel.
Bei einem Advanced-PDF (AES) deckt die Signatur jedes Byte davor ab, einschließlich der Feldwerte und der Nachweisseite. Jede nachträgliche Änderung an der Datei macht sie ungültig, was jeder PAdES-fähige Validator anzeigt. Die Signaturdetails benennen den Unterzeichner und verweisen auf seine verifizierte Identitätssitzung und Code-Bestätigung. Feldwerte werden Teil des Seiteninhalts und nicht zu Formularfeldern, sodass sie später nicht bearbeitet werden können und jeder PDF-Viewer sie anzeigt. Ein angekreuztes Kontrollkästchen zeigt ein Häkchen, und ein nicht angekreuztes bleibt so, wie das Dokument es dargestellt hat. Ein Signaturfeld, das höher als 24 Punkte ist, erhält zudem eine kleine Beschriftung unter der Signatur: Signed with Didit · gefolgt von den ersten 8 Zeichen der id der Signatur. Didit fügt die Feldwerte, die Nachweisseite und die Signatur hinter den Bytes des Dokuments ein, das dem Unterzeichner angezeigt wurde. Dieses Dokument ist ein exakter Präfix der signierten Datei, sodass sha256_original weiterhin mit dem signierten PDF abgeglichen werden kann.

Das Nachweis-PDF

Das Nachweis-PDF dokumentiert für einen Unterzeichner:
  • Die Stufe und das Format.
  • Den Namen des Unterzeichners, seine Zeichnungsberechtigung und bei KYB das Unternehmen.
  • Die verifizierte Identitätssitzung (nur Advanced (AES)).
  • Die Bestätigung: Kanal, maskiertes Ziel und Uhrzeit (nur Advanced (AES)).
  • Die IP-Adresse des Unterzeichners.
  • Jedes Dokument: Titel, Seitenanzahl und SHA-256 des Originals. Bei einem Word-Dokument der Name und SHA-256 der Word-Datei, die Konverterversion und der SHA-256 des PDFs.
  • Die übernommene Signatur: getippt (mit ihrem Handschriftstil) oder gezeichnet, wann sie übernommen wurde, sowie die Signatur- und Initialenbilder.
  • Jedes Feld pro Dokument: Bezeichnung, Seite und Typ, Wert (das Bild bei einer Signatur oder Initialen), Herkunft des Werts (zum Beispiel Vom Unterzeichner eingegeben, Verifizierter Ausweis oder Ihre API), Zeitpunkt des Ausfüllens (UTC) und bei einem vom Unterzeichner eingegebenen Wert dessen damalige IP-Adresse.
  • Die abschließende Einwilligung: der Text, dem der Unterzeichner auf dem Überprüfungsbildschirm zugestimmt hat, und der Zeitpunkt.
  • Den SHA-256 jeder signierten Datei und bei Advanced (AES) das Zertifikat (ausgestellt für, Aussteller, Seriennummer und Gültigkeit) sowie den Zeitstempel.
Die an jedes signierte PDF angehängte Seite hat denselben Inhalt ohne den Zertifikatsabschnitt, da sie vor dem Anwenden der Signatur hinzugefügt wird.

Eine Signatur erneut validieren

POST /v3/session/{session_id}/signatures/{node_id}/validate/ liest jedes signierte PDF des Schritts erneut ein und prüft dessen SHA-256-Hash. Bei einer fortgeschrittenen Signatur (AES) validiert der Aufruf auch die PAdES-Signatur, ihr Zertifikat, die Sperrdaten und den Zeitstempel. Eine einfache Signatur besitzt keine digitale Signatur, daher prüft der Vorgang ausschließlich die Integrität der Datei. Das Ergebnis wird in validation gespeichert und das aktualisierte signatures[] zurückgegeben. Senden Sie signature_id, um einen einzelnen Unterzeichner zu prüfen. Dies erfordert write:sessions, und in der Konsole entspricht dies dem Button Erneut validieren. Ein gespeichertes signiertes PDF, das nicht mehr mit seinem sha256_signed übereinstimmt, gibt 400 mit signature_document_changed zurück. Bis die Dokumente signiert sind, ist validation null. Wenn Didit das Ergebnis des Signierens nicht bestätigen kann, lautet validation { "valid": null, "reason": "signature_provider_outcome_unknown", "checked_at" } und status bleibt signing, bis dies geklärt ist: Behandeln Sie dies als nicht signiert.

Im PDF-Bericht

Der PDF-Bericht enthält einen Signaturbereich mit dem Unterzeichner, der Bestätigung, dem Zertifikat, dem Zeitstempel und den Dokumenten mitsamt ihren Hashes. Wenn die Dokumente Felder aufweisen, folgt eine Seite E-Signatur · Felder mit einer Tabelle pro Dokument: der Wert jedes Feldes, die Bilder von Signatur und Initialen, die Zeitpunkte und die Quellen. Der Signaturbereich folgt in einem KYC-Bericht nach der Bankverifizierung und in einem KYB-Bericht nach den Dokumenten. Übergeben Sie pages=signature, um nur diesen Bereich auszugeben.

Verwandte Themen

Zuletzt geändert am 7. November 2026