marketplace
POST /v1/marketplace/vendor/verification/subjects
Add a natural person to the identity file.
Authentification
Envoyez une clé d'API en tant que jeton du porteur (bearer token). Cet endpoint n'indique pas de permission spécifique dans la spécification, attribuez donc à votre clé le minimum requis et vérifiez la réponse plutôt que de faire des suppositions.
Cet endpoint ne prend aucun identifiant d'organisation. Votre clé identifie déjà l'organisation à laquelle elle appartient, et la réponse y est limitée.
Essayer
Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau 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> }'Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API
Détails
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.
Corps de la requête
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
kind | MarketplaceVerificationSubjectKind | Oui | 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 | Oui | — |
ownership_percent | integer | Non | — |
is_authorised | boolean | Non | — |
first_name | string | Non | 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 | Non | — |
date_of_birth | string | Non | ⛔ 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éponse
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
id | string | Oui | — |
kind | MarketplaceVerificationSubjectKind | Oui | 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 | Oui | — |
ownership_percent | integer | Non | 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 | Oui | The person authorised to act. An individual is trivially that person. |
state | MarketplaceVerificationSubjectState | Oui | — |
rejection_reason | string | Non | — |
Erreurs que cet point de terminaison peut renvoyer
401 · 404 · 422