Grundlagen
Halter und Verifizierung
Halter brauchen Sie für die Zulassung für Dritte: Kundendaten anlegen, verifizieren und im Antrag referenzieren.
Ein Halter ist eine eigene Ressource
Legen Sie Privatpersonen, Unternehmen und Einzelunternehmen unter /api/v1/holders an. Anträge referenzieren den Halter anschließend über holder_id. Die beim Erstellen aktuelle Revision wird im Antrag gespeichert.
- 01
Halter anlegen
Stammdaten speichern und die öffentliche Halter-ID übernehmen.
- 02
Falls nötig verifizieren
Prüfversuch starten, geforderte Nachweise hochladen und Status abrufen.
- 03
Im Antrag referenzieren
holder_idsenden. Die aktuelle Revision wird mit dem Antrag gespeichert.
Statuswerte der Verifizierung
| Status | Bedeutung | Im Antrag verwendbar |
|---|---|---|
unverified | Noch kein erfolgreicher Nachweis für diesen Datenstand. | Ja mit eigenem, im Dashboard freigeschalteten KBA-Großkundenzugang; bei Vollmacht auf Digital-Zulassen nein. |
pending | Nachweise fehlen oder werden geprüft. | Wie unverified. |
verified | Nachweis passt zur aktuellen Revision. | Ja. |
failed | Prüfung fehlgeschlagen. | Nur mit eigenem KBA-Großkundenzugang. |
Vollmacht bestimmt die Verifizierungspflicht
Bei Vollmacht auf Digital-Zulassen akzeptiert der produktive Antrag nur einen verifizierten Halter. Sind Sie selbst beim KBA als Großkunde registriert und lautet die Vollmacht auf Ihr Unternehmen, prüfen Sie die Halterdaten in eigener Verantwortung — der Halter darf dann unverifiziert bleiben. Diese Freischaltung wird in Ihrem Dashboard-Konto hinterlegt.
Halterverifizierung, QES und Signatur
Unternehmen nutzen eine bestehende Unternehmensprüfung
Für Unternehmenshalter startet die Public API keinen neuen Register- oder Identifizierungsablauf und nimmt keine Registerdatei an. Firmenname und Registerdaten werden mit der vorhandenen Dashboard-/Yousign-Unternehmensprüfung verglichen. Ohne Übereinstimmung lautet das Ergebnis failed mit company_verification_required.
Änderungen und Revisionen
Identitäts- oder Adressänderungen erzeugen eine neue Revision und können verified zurücksetzen. Bereits angelegte Anträge behalten ihren Snapshot. Nutzen Sie bei PATCH If-Match, damit parallele Änderungen nicht unbemerkt überschrieben werden.