marketplace

PUT `/v1/marketplace/vendor/verification`

Open the identity file on a track, or edit it.

Pagpapatotoo

Magpadala ng API key bilang bearer token. Ang endpoint na ito ay hindi naglatag ng tiyak na pahintulot sa pagtutukoy, kaya ibigay sa iyong key ang pinakamababang kailangan nito at suriin ang tugon sa halip na umasa.

Ang endpoint na ito ay hindi nangangailangan ng id ng organisasyon. Natutukoy na ng iyong key ang organisasyong kinabibilangan nito, at nakatuon ang tugon dito.

Subukan ito

Palitan ang anuman sa loob ng mga panaklong na may anggulo ng iyong sariling mga halaga, at ang placeholder ng key na may key mula sa iyong dashboard.

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> }'

Nakalagda? Ang API console sa iyong dashboard ay awtomatikong naglalagay ng iyong tunay na ID ng organisasyon at sariling susi, at pinapatakbo ang kahilingan laban sa live na API upang makita mo ang aktwal na tugon. Buksan ang endpoint na ito sa console ng API

Mga Detalye

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.

Katawan ng kahilingan

Pangalan	Uri	Kailangan	Ano ito
`track`	`MarketplaceVerificationTrack`	Oo	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 natu…
`legal_name`	`string`	Oo	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 an…
`country`	`string`	Hindi	ISO-3166-1 alpha-2.
`company_number`	`string`	Hindi	—
`registered_address`	`string`	Hindi	—
`tin`	`string`	Hindi	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. ⛔ R…
`tin_issued_in`	`string`	Hindi	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 th…
`tin_unavailable_reason`	`string<jurisdiction_does_not_issue, jurisdiction_does_not_require>`	Hindi	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`	Hindi	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 wou…
`accept_self_billing`	`boolean`	Hindi	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` i…
`self_billing_vat_status`	`string<unknown, registered, not_registered>`	Hindi	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`	Hindi	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…

Tugon

Pangalan	Uri	Kailangan	Ano ito
`verification`	`MarketplaceVerification`	Oo	—
`requirements`	`MarketplaceVerificationRequirements`	Oo	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.

Mga error na maibabalik ng endpoint na ito

401 · 404 · 422

PUT /v1/marketplace/vendor/verification