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 SitzungApproved,Declined,In ReviewoderAbandonedist. - 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 vondocuments[].fields[] ist ein Feld des Dokuments mit seinem Wert auf der Kopie für diesen Unterzeichner:
Signierte Dokumente herunterladen
Verwenden Sie die Pfade insigned_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:- Die Seiten des Dokuments, die dem Unterzeichner angezeigt wurden, wobei jeder Feldwert an der von Ihnen platzierten Stelle eingestempelt ist.
- Die Nachweisseite, es sei denn, Sie haben
signature_evidence_pagedeaktiviert. - 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.
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.
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 Siepages=signature, um nur diesen Bereich auszugeben.