marketplace
POST /v1/marketplace/vendor/verification/subjects
Add a natural person to the identity file.
Autenticación
Envía una clave de API como token de portador. Este endpoint no especifica un permiso concreto en la especificación, así que otorga a tu clave los mínimos privilegios necesarios y comprueba la respuesta en lugar de dar por sentado.
Este endpoint no requiere ningún id de organización. Su clave ya identifica la organización a la que pertenece, y la respuesta está delimitada a ella.
Pruébalo
Reemplaza cualquier elemento entre corchetes angulares por tus propios valores, y el marcador de posición key con una clave de tu panel de control.
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> }'¿Has iniciado sesión? La consola de la API en tu panel de control rellena el ID de tu organización real y tu propia clave, y ejecuta la solicitud contra la API en vivo para que puedas ver la respuesta real. Abre este endpoint en la consola de la API
Detalles
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.
Cuerpo de la solicitud
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
kind | MarketplaceVerificationSubjectKind | Sí | 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 | Sí | — |
ownership_percent | integer | No | — |
is_authorised | boolean | No | — |
first_name | string | No | 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 | No | — |
date_of_birth | string | No | ⛔ 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… |
Respuesta
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
id | string | Sí | — |
kind | MarketplaceVerificationSubjectKind | Sí | 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 | Sí | — |
ownership_percent | integer | No | 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 | Sí | The person authorised to act. An individual is trivially that person. |
state | MarketplaceVerificationSubjectState | Sí | — |
rejection_reason | string | No | — |
Errores que este endpoint puede devolver
401 · 404 · 422