marketplace
POST /v1/marketplace/vendor/verification/subjects
Add a natural person to the identity file.
Tabbatar da Asali
Aiko da maɓallin API a matsayin bearer token. Wannan ma'anar ba ta bayyana takamaiman izini ba a cikin ƙayyadaddun bayanai, don haka ba wa maɓallin ku mafi ƙarancin abin da yake buƙata kuma ku bincika amsar maimakon yin zato.
Wannan wurin ƙarewa ba ya buƙatar ID na ƙungiya. Maɓallin ku ya riga ya gano ƙungiyar da yake ciki, kuma an iyakance amsa a kanta.
Gwada
May gurbin komai da ke cikin kusurwa da ƙimar ka, kuma may gurbin maballi da maballi daga allon sarrafa ka.
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> }'An shiga? Na'urar sarrafa API da ke cikin sashin kulawarka tana cika ainihin lambar ƙungiyarka da maɓallinka naka, sannan tana gudanar da buƙatar a kan ainihin API don haka zaka iya ganin amsar gaske. Buɗe wannan tashar a cikin na'urar kula da API
Bayani
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.
Jikin buƙata
| Suna | Nau'i | Ana buƙata | Abin da yake |
|---|---|---|---|
kind | MarketplaceVerificationSubjectKind | Eh | 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 | Eh | — |
ownership_percent | integer | A'a | — |
is_authorised | boolean | A'a | — |
first_name | string | A'a | 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 | A'a | — |
date_of_birth | string | A'a | ⛔ 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… |
Martani
| Suna | Nau'i | Ana buƙata | Abin da yake |
|---|---|---|---|
id | string | Eh | — |
kind | MarketplaceVerificationSubjectKind | Eh | 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 | Eh | — |
ownership_percent | integer | A'a | 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 | Eh | The person authorised to act. An individual is trivially that person. |
state | MarketplaceVerificationSubjectState | Eh | — |
rejection_reason | string | A'a | — |
Kuskuren da wannan matsaya za ta iya maido wa
401 · 404 · 422