Halter aktualisieren

Senden Sie nur die zu ändernden Felder. If-Match bindet die Änderung an die bekannte Revision und verhindert, dass parallele Aktualisierungen einander überschreiben. Erforderlich ist holders:write.

Beschreibung

Aktualisiert Halterdaten und erhöht bei Identitätsänderungen die Revision.

Parameter

holder_idpathPflicht

Öffentliche Halter-ID.

Beispiel: hld_test_1a2b3c4d5e6f708192a3b4c5

If-MatchheaderPflicht

Zuletzt gelesene Revisionsnummer in Anführungszeichen.

Beispiel: "1"

Request-Body

Der Body wird als application/json übertragen. Verwenden Sie ausschließlich die dokumentierten Feldnamen.

Request-Felder

Feld	Typ	Angabe	Beschreibung
`type`	enum	Optional	Neuer Haltertyp. Das resultierende Objekt muss die zugehörigen Pflichtfelder enthalten.
`first_name, last_name`	string\|null	Optional	Personenname; `null` entfernt den jeweiligen Wert.
`birth_date`	date\|null	Optional	Geburtsdatum im Format YYYY-MM-DD.
`birth_place, birth_name, title`	string\|null	Optional	Weitere Personendaten.
`gender`	enum\|null	Optional	Geschlecht oder `null`.
`company_name`	string\|null	Optional	Unternehmensname.
`register`	object\|null	Optional	Registertyp und Registernummer.
`business_sector`	string\|null	Optional	Dreistelliger Wirtschaftszweig.
`email, phone`	string\|null	Optional	Kontaktdaten.
`address`	object	Optional	Vollständige Anschrift mit Straße, Hausnummer, Postleitzahl und Ort.
`external_reference`	string\|null	Optional	Referenz aus dem eigenen System.

{
  "phone": "+491701234568",
  "address": {
    "street": "Am Markt",
    "house_number": "14",
    "postal_code": "28195",
    "city": "Bremen",
    "country_code": "DE"
  }
}

SchemaquelleOpenAPI 3.1 herunterladen

Responses

200

Aktualisierter Halter mit erhöhter Versionsnummer.

409

If-Match entspricht nicht mehr der aktuellen Revision.

422

Die partielle Änderung ergibt kein gültiges Halterobjekt.

Response-Body

Content-Type: application/json. Die erfolgreiche Antwort enthält die nachfolgend beschriebenen Felder.

Response-Felder

Feld	Typ	Angabe	Beschreibung
`id`	string	Immer	Öffentliche Halter-ID.
`object`	string	Immer	Konstanter Wert `holder`.
`environment`	enum	Immer	`test` oder `live`.
`livemode`	boolean	Immer	`true` für Live-Ressourcen.
`revision`	integer	Immer	Fortlaufende Versionsnummer der Halterdaten; erhöht sich bei Änderungen.
`external_reference`	string\|null	Optional	Referenz aus dem eigenen System.
`verification_status`	enum	Immer	`unverified`, `pending`, `verified` oder `failed`.
`data`	object	Immer	Personen-, Unternehmens-, Kontakt- und Anschriftdaten der aktuellen Revision.
`created_at`	date-time	Immer	Erstellungszeitpunkt im ISO-8601-Format.
`updated_at`	date-time	Immer	Letzte Änderung im ISO-8601-Format.

{
  "id": "hld_test_1a2b3c4d5e6f708192a3b4c5",
  "object": "holder",
  "environment": "test",
  "livemode": false,
  "external_reference": "customer-1842",
  "revision": 2,
  "verification_status": "unverified",
  "data": {
    "type": "person",
    "first_name": "Mara",
    "last_name": "Beispiel",
    "birth_date": "1988-04-12",
    "birth_place": "Bremen",
    "email": "mara.beispiel@example.com",
    "phone": "+491701234568",
    "address": {
      "street": "Am Markt",
      "house_number": "14",
      "postal_code": "28195",
      "city": "Bremen",
      "country_code": "DE"
    }
  },
  "created_at": "2026-08-26T10:15:00+02:00",
  "updated_at": "2026-08-26T10:15:00+02:00"
}

Wann verified zurückgesetzt wird

Änderungen an Name, Geburtsdaten, Firma, Register oder Anschrift setzen eine bestehende Verifizierung für die neue Revision zurück. Reine Kontaktänderungen können den Status erhalten, sofern sie nicht Teil des geprüften Nachweises waren.

{ "id": "hld_test_1a2b3c4d5e6f708192a3b4c5", "object": "holder", "environment": "test", "livemode": false, "external_reference": "customer-1842", "revision": 2, "verification_status": "unverified", "data": { "type": "person", "first_name": "Mara", "last_name": "Beispiel", "birth_date": "1988-04-12", "birth_place": "Bremen", "email": "mara.beispiel@example.com", "phone": "+491701234568", "address": { "street": "Am Markt", "house_number": "14", "postal_code": "28195", "city": "Bremen", "country_code": "DE" } }, "created_at": "2026-08-26T10:15:00+02:00", "updated_at": "2026-08-26T10:15:00+02:00" }