marketplace
POST /v1/marketplace/vendor/verification/subjects
Add a natural person to the identity file.
Authentifizierung
Senden Sie einen API-Schlüssel als Bearer-Token. Dieser Endpunkt gibt in der Spezifikation keine spezifische Berechtigung an. Versehen Sie Ihren Schlüssel daher mit den minimal erforderlichen Rechten und prüfen Sie die Antwort, anstatt Annahmen zu treffen.
Dieser Endpunkt erfordert keine Organisations-ID. Ihr Schlüssel identifiziert bereits die zugehörige Organisation, und die Antwort ist entsprechend eingeschränkt.
Ausprobieren
Ersetzen Sie alles in spitzen Klammern durch Ihre eigenen Werte und den Platzhalter für den Schlüssel durch einen Schlüssel aus Ihrem Dashboard.
curl -X POST https://api.zinndigital.com/v1/marketplace/vendor/verification/subjects \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "kind": <MarketplaceVerificationSubjectKind>, "full_name": <string> }'Angemeldet? Die API-Konsole in Ihrem Dashboard trägt automatisch Ihre echte Organisations-ID sowie Ihren eigenen Schlüssel ein und führt die Anfrage gegen die Live-API aus, sodass Sie die tatsächliche Antwort sehen können. Öffnen Sie diesen Endpunkt in der API-Konsole
Details
One person on the individual track. On the company track, the person authorised to act plus **each beneficial owner over 25%** — a holding below that threshold is refused rather than recorded, because a person on a file whose presence nobody can later explain is worse than an absent one.
Anfragekörper
| Name | Typ | Erforderlich | Was es ist |
|---|---|---|---|
kind | MarketplaceVerificationSubjectKind | Ja | Why a natural person appears on the file. `primary` is the individual themselves, or the person authorised to act for a company; `beneficial_owner` is a holder of more than 25%.… |
full_name | string | Ja | — |
ownership_percent | integer | Nein | — |
is_authorised | boolean | Nein | — |
first_name | string | Nein | DAC7 reports an individual seller's name as separate elements (docs/298 §2a). ⭐ Beside `full_name`, not instead of it: that is the name as it appears on the identity DOCUMENT, w… |
last_name | string | Nein | — |
date_of_birth | string | Nein | ⛔ Mandatory in HMRC's schema for an individual seller — `PersonParty_Type` declares `BirthInfo` without `minOccurs="0"` — so a file without one produces a return HMRC rejects. A… |
Antwort
| Name | Typ | Erforderlich | Was es ist |
|---|---|---|---|
id | string | Ja | — |
kind | MarketplaceVerificationSubjectKind | Ja | Why a natural person appears on the file. `primary` is the individual themselves, or the person authorised to act for a company; `beneficial_owner` is a holder of more than 25%.… |
full_name | string | Ja | — |
ownership_percent | integer | Nein | Null on the individual track and for a pure authorised signatory. A holding of 25% or less is refused rather than recorded. |
is_authorised | boolean | Ja | The person authorised to act. An individual is trivially that person. |
state | MarketplaceVerificationSubjectState | Ja | — |
rejection_reason | string | Nein | — |
Fehler, die dieser Endpunkt zurückgeben kann
401 · 404 · 422