marketplace
POST /v1/marketplace/vendor/verification/subjects
Add a natural person to the identity file.
Autentificare
Trimiteți o cheie API ca token de tip bearer. Acest punct final nu specifică o permisiune anume în specificație, așa că acordați cheii cele mai puține drepturi necesare și verificați răspunsul în loc să faceți presupuneri.
Acest endpoint nu necesită un ID de organizație. Cheia ta identifică deja organizația căreia îi aparține, iar răspunsul este limitat la aceasta.
Încearcă
Înlocuiți tot ce se află între paranteze unghiulare cu propriile valori și substituentul cheie cu o cheie din tabloul de bord.
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> }'Autentificat? Consola API din panoul de control îți completează ID-ul real al organizației și propria cheie și rulează cererea în API-ul live, astfel încât să poți vedea răspunsul efectiv. Deschideți acest punct final în consola API
Detalii
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.
Corp cerere
| Nume | Tip | Obligatoriu | Ce este |
|---|---|---|---|
kind | MarketplaceVerificationSubjectKind | Da | 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 | Da | — |
ownership_percent | integer | Nu | — |
is_authorised | boolean | Nu | — |
first_name | string | Nu | 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 | Nu | — |
date_of_birth | string | Nu | ⛔ 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… |
Răspuns
| Nume | Tip | Obligatoriu | Ce este |
|---|---|---|---|
id | string | Da | — |
kind | MarketplaceVerificationSubjectKind | Da | 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 | Da | — |
ownership_percent | integer | Nu | 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 | Da | The person authorised to act. An individual is trivially that person. |
state | MarketplaceVerificationSubjectState | Da | — |
rejection_reason | string | Nu | — |
Erori pe care le poate returna acest punct final
401 · 404 · 422