marketplace
PUT /v1/marketplace/vendor/verification
Open the identity file on a track, or edit it.
Баталгаажуулалт
API түлхүүрийг bearer token хэлбэрээр илгөэнэ үү. Энэхүү төгсгөлийн цэг нь тодорхойлолтдоо тодорхой зөвшөөрлийг заагаагүй тул түлхүүрээрээ шаардагдах хамгийн бага эрхийг өгч, таамаглахаас илүүтэйгээр хариуг шалгана уу.
Энэ төгсгөл цэг нь ямар ч байгууллагын ID шаардахгүй. Таны түлхүүр аль хэдийн харьяалагдах байгууллагыг тодорхойлж байгаа бөгөөд хариу нь тухайн байгууллагын хүрээнд хязгаарлагдана.
Туршиж үзэх
Өнцөг хаалтанд байгаа бүх зүйлийг өөрийн утгаар солиж, түлхүүр санамж байрлуулагчийг хяналтын самбарынхаа түлхүүрээр сольж оруулна уу.
curl -X PUT https://api.zinndigital.com/v1/marketplace/vendor/verification \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "track": <MarketplaceVerificationTrack>, "legal_name": <string> }'Та нэвтэрсэн байна уу? Таны хяналтын самбар дахь API консол нь таны бодит байгууллагын ID болон өөрийн түлхүүрийг автоматаар бөглөж, шууд ажиллаж буй API рүү хүсэлт илгээх тул та бодит хариуг харах боломжтой болно. Энэ төгсгөлийн цэгийг API консол дээр нээх
Дэлгэрэнгүй
docs/82 §7a. Two tracks, chosen here: individual and company. They are not the same shape with extra fields — the required documents differ, the number of natural persons differs (one, versus every beneficial owner over 25%), and the approval rule differs, because a company is not verified until every required owner is. ⛔ PUT, not POST: there is exactly one file per seller and sending the form twice must not make two. ⛔ Refused once the file is in review or approved — the reviewer approves what they saw.
Хүсэлтийн бие
| Нэр | Төрөл | Заавал шаардлагатай | Энэ юу вэ |
|---|---|---|---|
track | MarketplaceVerificationTrack | Тийм | Which set of rules the identity file is judged against (docs/82 §7a). The company track is not the individual track with extra fields: the required documents, the number of… |
legal_name | string | Тийм | The name exactly as it appears on the documents — a person's on the individual track, the company's on the company track. Not the storefront name: a storefront name is chosen and… |
country | string | Үгүй | ISO-3166-1 alpha-2. |
company_number | string | Үгүй | — |
registered_address | string | Үгүй | — |
tin | string | Үгүй | The seller's Tax Identification Number (docs/298 §2). For a UK company this is the CRN; for a UK individual their National Insurance number; elsewhere the local TIN. ⛔… |
tin_issued_in | string | Үгүй | ISO-3166-1 alpha-2 jurisdiction that ISSUED the TIN. ⛔ Not the same as country: a person resident in Ireland can hold a UK NI number, and reporting the residence country as the… |
tin_unavailable_reason | string<jurisdiction_does_not_issue, jurisdiction_does_not_require> | Үгүй | Why there is no TIN, where there legitimately is none. ⛔ There is deliberately no "seller refused" value — that is not a reason a TIN is unavailable, it is the reason the payout… |
residential_address | string | Үгүй | The individual seller's primary residence, as DAC7 asks for it. Individual track only — on the company track the primary address is registered_address, and a second column would… |
accept_self_billing | boolean | Үгүй | Accept the self-billing agreement (docs/82 §8). Recorded with a timestamp and never cleared; required before the file can be submitted. Refused while self_billing_vat_status is… |
self_billing_vat_status | string<unknown, registered, not_registered> | Үгүй | Whether you are VAT registered. not_registered is a perfectly ordinary answer and self-bills correctly with no number on the document; what we cannot do is proceed without an… |
self_billing_vat_number | string | Үгүй | Your VAT registration number. Required when self_billing_vat_status is registered: an invoice we raise in your name must show it, or neither of us can account for the tax on… |
Хариу үйлдэл
| Нэр | Төрөл | Заавал шаардлагатай | Энэ юу вэ |
|---|---|---|---|
verification | MarketplaceVerification | Тийм | — |
requirements | MarketplaceVerificationRequirements | Тийм | What the file still needs, computed from the track. ⭐ Published so a screen renders the checklist rather than re-implementing the track rules and drifting from them. |
Энэ төгсгөл цэгээс буцааж болох алдаанууд
401 · 404 · 422