Sitzungsdaten-API: KYC- & KYB-Felder aktualisieren

​

Gemeinsame Anforderungen

• Autorisierung: API-Schlüssel (standardmäßiger x-api-key- bzw. Authorization-Bearer) oder Benutzer-Autorisierungstoken.
• Berechtigung:
  • KYC und POA: write:sessions
  • KYB-Unternehmensdaten und Schlüsselpersonen-Partei: write:businesses
• Sitzungsstatus (nur KYC / POA): muss einer der folgenden Werte sein: APPROVED, DECLINED, IN_REVIEW oder KYC_EXPIRED. Sitzungen, die noch keinen prüfbaren Zustand erreicht haben, können nicht geändert werden. Für KYB-Unternehmensaktualisierungen gibt es keine Statusbeschränkung.
• Datensatz der Funktion muss vorhanden sein: KYC-Felder können nur geändert werden, wenn die Sitzung ein KYC erfasst hat, POA-Felder nur, wenn sie einen POA erfasst hat, und KYB-Unternehmensfelder nur, wenn die Sitzung eine Prüfung des Unternehmensregisters enthält.
• Teilaktualisierungen: Nur die Felder, die Sie senden, werden geändert. Lassen Sie ein Feld weg, bleibt es unverändert. Senden Sie null, um einen extra_fields-Schlüssel zu entfernen.
• Webhooks: Eine erfolgreiche Aktualisierung löst data.updated mit session_kind: "user" oder "business" aus. Im Audit-Log der Sitzung wird festgehalten, welche konkreten Felder geändert wurden und wer die Änderung vorgenommen hat.

​

KYC-Identitätsdaten aktualisieren

​

Änderbare Felder

​

Beispiel

curl -X PATCH "https://verification.didit.me/v3/session/4c5c7f3a.../update-data/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1990-01-01",
    "issuing_state": "ESP",
    "extra_fields": { "municipality": "Madrid" }
  }'

​

Adressnachweis-Daten (POA) aktualisieren

​

Änderbare Felder

​

Beispiel

curl -X PATCH "https://verification.didit.me/v3/session/4c5c7f3a.../update-poa-data/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "utility_bill",
    "issuer": "Iberdrola",
    "issue_date": "2026-03-15",
    "name_on_document": "Jane Doe",
    "poa_parsed_address": {
      "street_1": "Calle Mayor 10",
      "city": "Madrid",
      "postal_code": "28013",
      "country": "ES"
    }
  }'

​

KYB-Unternehmensdaten aktualisieren

​

Voraussetzungen

• Berechtigung: write:businesses (unterscheidet sich von der Berechtigung für KYC und Adressnachweis).
• Die companyUuid in der URL muss zur angegebenen sessionId gehören, andernfalls erhalten Sie einen 404-Fehler.
• Keine Statusprüfung der Sitzung: Die KYB-Unternehmensdaten können jederzeit korrigiert werden.

​

Änderbare Felder

​

Beispiel

curl -X PATCH "https://verification.didit.me/v3/session/bs-01HJX1.../kyb/f7a9c1b2-4e6d.../update-data/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Acme Corporation Limited",
    "registration_number": "12345678",
    "registry_status": "active",
    "legal_address": "1 Main Street, London EC1A 1AA, United Kingdom",
    "alternative_names": "Acme Ltd, Acme Group"
  }'

​

Eine Partei der Schlüsselpersonen überspringen

​

Voraussetzungen

• Berechtigung: write:businesses.
• Die partyUuid in der URL muss zur angegebenen sessionId gehören, andernfalls erhalten Sie einen 404-Fehler.
• Nicht durch allow_skip eingeschränkt. Diese Rollen-Einstellung begrenzt, was der Antragsteller beim Ausfüllen des gehosteten Bildschirms für Schlüsselpersonen überspringen darf. Dieser Endpoint ist die vom Betreiber vorgenommene Überschreibung und funktioniert daher auch bei Rollen, die der Antragsteller nicht hätte überspringen können.

​

Body

​

Beispiel

curl -X PATCH "https://verification.didit.me/v3/session/bs-01HJX1.../kyb/parties/0a3f1e2c-7c2f.../" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "is_skipped": true }'

​

Was nach einer Aktualisierung passiert

• Webhook: data.updated wird für die Sitzung ausgelöst, wobei die Payload das session_kind der Sitzung enthält ("user" oder "business"). Abonnieren Sie ihn einmal auf Ziel-Ebene und leiten Sie anhand von session_kind weiter.
• Audit-Log: Die Sitzung protokolliert genau, welche Felder sich geändert haben, die bisherigen und neuen Werte und (bei Aufrufen mit Benutzerauthentifizierung) die E-Mail-Adresse des Akteurs. Sichtbar im Events-Tab der Konsole.
• Erneutes Geocoding der Adresse: Bei KYC- und Adressnachweis-Aktualisierungen, die address bzw. poa_address ändern, führt Didit das Geocoding im Hintergrund erneut aus. Fehler werden stillschweigend ignoriert, sodass eine Aktualisierung nie wegen eines Geocoding-Problems fehlschlägt.
• Erneutes AML-Screening: KYC-Aktualisierungen, die Name, Geburtsdatum oder Staatsangehörigkeit ändern, können ein erneutes AML-Screening auslösen, sofern das AML-Screening für die Sitzung noch nicht abgeschlossen war. Die Ergebnisse erscheinen in der Sitzungsentscheidung.

​

Wann Sie diese Endpoints nicht verwenden sollten

• Gesamte Verifizierung erneut durchführen: Muss der Kunde sein Ausweisfoto erneut aufnehmen oder ein Dokument erneut hochladen, verwenden Sie update-status, um die Sitzung auf Resubmitted zu setzen.
• Profilfelder der Entität User oder Business ändern: Verwenden Sie PATCH /v3/users/{vendor_data}/ oder PATCH /v3/businesses/{vendor_data}/. Diese Endpoints aktualisieren Daten auf Entitätsebene, nicht Daten auf Sitzungsebene.
• Details zu den Schlüsselpersonen bearbeiten: Es gibt keine öffentliche API, um Name, Rollen oder Eigentumsverhältnisse einer Partei zu ändern; diese Daten werden über den gehosteten Ablauf übermittelt. Das einzige änderbare Feld ist is_skipped (siehe Eine Partei der Schlüsselpersonen überspringen).

​

Fehler

​

Nächste Schritte