E-Signatur-Warnungen und Risikocodes

Ein E-Signatur-Schritt gibt eine Warnung aus, wenn ein Unterzeichner nicht signieren kann oder will: Er lehnt ab, hat keine Codes mehr übrig oder kann keiner verifizierten Identität zugeordnet werden, oder ein Dokument stimmt nicht mehr mit dem überein, was ihm angezeigt wurde. Jede Warnung stoppt die Signatur dieses Unterzeichners, sodass dafür kein signiertes Dokument ausgestellt wird. Wie sich die Warnung auf die Entscheidung auswirkt, liegt bei Ihnen.

Übersicht

Eine Warnung erscheint an zwei Stellen:

Im Eintrag des Unterzeichners in signatures[], als { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" } in warnings[]. Siehe E-Signatur-Bericht.
In der Aktivität der Sitzung, getaggt mit der Funktion SIGNATURE, mit ihrem Titel und ihrer Beschreibung. Die Console zeigt sie im Reiter Signatur der Sitzung an, und additional_data.signature_id verweist auf den Unterzeichner.

Jeder Code ist einer Regel zugeordnet. Legen Sie die Regel pro Workflow-Schritt im Console-Reiter Regeln oder in der Konfiguration des Schritts auf DECLINE, REVIEW oder NO_ACTION fest. Die Regel bestimmt das verdict des Unterzeichners (Declined, In Review oder Approved) und den Schweregrad der Warnung (error, warning oder information). Benutzerdefinierte Statusregeln für den Schritt werden danach angewendet.

Eine Regel bestimmt die Entscheidung, nicht, ob die Dokumente signiert sind. NO_ACTION lässt den Workflow fortfahren, aber der Unterzeichner hat noch immer nicht signiert. Prüfen Sie, ob status den Wert signed hat, bevor Sie sich auf eine Signatur verlassen.

Erzeugte Warnungen

Code	Wann sie ausgelöst wird	Regel und Standardwert
`SIGNATURE_DECLINED`	Der Unterzeichner hat die Signatur abgelehnt. Es wird keine signierte Kopie ausgestellt und nichts in Rechnung gestellt.	`signature_declined_action`, Standardwert `REVIEW`
`SIGNATURE_OTP_FAILED`	Der Unterzeichner hat 3 falsche Codes eingegeben oder mehr als 5 Codes angefordert.	`signature_otp_failed_action`, Standardwert `DECLINE`
`SIGNATURE_NAME_MISMATCH`	KYB: Der für die Schlüsselperson angegebene Name stimmt nicht mit deren verifiziertem Namen überein (Groß-/Kleinschreibung und Leerzeichen werden ignoriert).	`signature_name_mismatch_action`, Standardwert `DECLINE`
`SIGNATURE_IDENTITY_NOT_VERIFIED`	Der Unterzeichner verfügt über keine genehmigte Ausweisverifizierung mit Namen, eine Liveness-Erkennung in seiner Sitzung ist nicht genehmigt oder die Ausweisverifizierung hat sich geändert, nachdem der Unterzeichner begonnen hat.	`signature_identity_not_verified_action`, Standardwert `DECLINE`
`SIGNATURE_DOCUMENT_CHANGED`	Ein Dokument stimmt nicht mehr mit dem SHA-256-Wert überein, der erfasst wurde, als es dem Unterzeichner angezeigt wurde.	`signature_document_changed_action`, Standardwert `DECLINE`

Die Identitäts- und Namensprüfungen werden ausgeführt, wenn der Unterzeichner seinen Code anfordert, und erneut, wenn er ihn eingibt. Daher erscheinen diese Warnungen zu diesem Zeitpunkt und nicht beim Öffnen des Schritts.

Ablehnungen können wieder geöffnet werden

SIGNATURE_DECLINED ist die einzige Warnung, die ein Unterzeichner rückgängig machen kann. Solange der Signaturlink gültig ist, kann ein Unterzeichner, der abgelehnt hat, den Schritt erneut öffnen und signieren. Das erneute Öffnen setzt die Warnung des Unterzeichners sowie dessen Lesen und Zustimmung für jedes Dokument zurück, sodass er die Dokumente erneut durchgeht. Die Warnung wird aus den Aktivitäten der Sitzung entfernt, sobald kein Unterzeichner des Schritts mehr ablehnt. Das erneute Öffnen setzt die Code-Versuche nicht zurück. Die anderen Warnungen sind für diesen Unterzeichner endgültig.

Probleme, die der Unterzeichner sieht

Diese stoppen den Unterzeichner, ohne eine Warnung auszulösen. Der Ablauf informiert ihn darüber, was passiert ist.

Situation	Was passiert
Der Signaturlink ist abgelaufen	Der Schritt kann nach `expires_at` nicht mehr geöffnet oder abgeschlossen werden. Der Link ist ab der Erstellung der Sitzung für `signature_link_validity_days` Tage gültig.
Der Code ist abgelaufen	Codes sind 5 Minuten lang gültig. Der Unterzeichner fordert einen neuen an.
Ein neuer Code wurde zu früh angefordert	Der Unterzeichner wartet 60 Sekunden zwischen zwei Codes.
Kein verifizierter Kontakt	Der Code wird nur an eine E-Mail-Adresse oder Telefonnummer gesendet, die zuvor in der Sitzung verifiziert wurde. Fügen Sie vor dem Signaturschritt eine E-Mail-Verifizierung oder Telefonverifizierung hinzu.
Ein Pflichtfeld ist leer	Der Unterzeichner kann ein Dokument erst fertigstellen, wenn jedes Pflichtfeld darauf einen Wert enthält. Der Ablauf zeigt an, wie viele noch fehlen, und springt zum ersten.
Der Wert eines Feldes wird abgelehnt	Ein Wert, der die Validierung seines Feldes verletzt (z. B. zu lang oder keine Zahl), wird abgelehnt und der Ablauf erklärt den Grund.
Die App ist zu alt für Felder	Ein natives SDK-Release ohne Unterstützung für Felder kann ein Dokument mit Feldern nicht anzeigen, und der Schritt zeigt einen Fehler an. Dokumente ohne Felder funktionieren weiterhin. Siehe Das Signieren.

Beispiel

{
  "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
    }
  ]
}

Das Beispiel zeigt nur die Felder, die sich ändern. Alle anderen Felder des Signaturobjekts sind weiterhin vorhanden.

Warnungstypen

Der Schweregrad jeder Warnung richtet sich nach der von Ihnen festgelegten Regel. Die Schweregrade werden in drei Kategorien eingeteilt:

Authentifizierung

Verifizierung

Überwachung

Plattform

E-Signatur-Warnungen und Risikocodes

Übersicht

Erzeugte Warnungen

Ablehnungen können wieder geöffnet werden

Probleme, die der Unterzeichner sieht

Beispiel

Warnungstypen

Verwandte Themen

​Übersicht

​Erzeugte Warnungen

​Ablehnungen können wieder geöffnet werden

​Probleme, die der Unterzeichner sieht

​Beispiel

​Warnungstypen

​Verwandte Themen

Übersicht

Erzeugte Warnungen

Ablehnungen können wieder geöffnet werden

Probleme, die der Unterzeichner sieht

Beispiel

Warnungstypen

Verwandte Themen