marketplace

PUT `/v1/marketplace/vendor/verification`

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

توثيقِ شناخت

ایک API کلید بطور بیر ٹوکن (bearer token) ارسال کریں۔ یہ اینڈ پوائنٹ اسپیسیفیکیشن میں کسی مخصوص اجازت کا ذکر نہیں کرتا، اس لیے فرض کرنے کے بجائے اپنی کلید کو کم از کم درکار اجازت دیں اور رسپانس چیک کریں۔

یہ اینڈ پوائنٹ کوئی آرگنائزیشن آئی ڈی نہیں لیتا۔ آپ کی کلید پہلے ہی اس آرگنائزیشن کی شناخت کرتی ہے جس سے یہ تعلق رکھتی ہے، اور اس کا جواب اسی کے مطابق محدود ہوتا ہے۔

آزمائیں

کوئی بھی چیز جو زاویہ دار قوسین میں ہو اسے اپنی اقدار سے بدلیں، اور کلیدی پلیس ہولڈر کو اپنے ڈیش بورڈ کی کسی کلید سے بدلیں۔

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 کنسول آپ کی حقیقی تنظیم کی آئی ڈی اور آپ کی اپنی کلید خود بخود پُر کر دیتا ہے، اور لائیو 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 natu…
`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 an…
`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. ⛔ R…
`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 th…
`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 wou…
`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` i…
`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

PUT /v1/marketplace/vendor/verification