marketplace
PUT /v1/marketplace/vendor/verification
Open the identity file on a track, or edit it.
Xác thực
Gửi khóa API dưới dạng mã thông báo bearer. Điểm cuối này không nêu rõ quyền cụ thể trong thông số kỹ thuật, vì vậy hãy cấp cho khóa của bạn quyền tối thiểu cần thiết và kiểm tra phản hồi thay vì phỏng đoán.
Endpoint này không nhận ID tổ chức. Khóa của bạn đã xác định tổ chức mà nó thuộc về và phản hồi được giới hạn trong phạm vi đó.
Dùng thử
Thay thế bất kỳ nội dung nào trong ngoعل (angle brackets) bằng giá trị của riêng bạn và trình giữ chỗ key bằng một key từ trang tổng quan của bạn.
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> }'Đã đăng nhập? Bảng điều khiển API trong trang quản lý của bạn sẽ tự điền ID tổ chức thực tế và khóa của riêng bạn, sau đó chạy yêu cầu đối với API trực tiếp để bạn có thể xem phản hồi thực tế. Mở điểm cuối này trong bảng điều khiển API
Chi tiết
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.
Nội dung yêu cầu
| Tên | Loại | Bắt buộc | Nội dung này là gì |
|---|---|---|---|
track | MarketplaceVerificationTrack | Có | 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 | Có | 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 | Không | ISO-3166-1 alpha-2. |
company_number | string | Không | — |
registered_address | string | Không | — |
tin | string | Không | 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 | Không | 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> | Không | 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 | Không | 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 | Không | 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> | Không | 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 | Không | 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… |
Phản hồi
| Tên | Loại | Bắt buộc | Nội dung này là gì |
|---|---|---|---|
verification | MarketplaceVerification | Có | — |
requirements | MarketplaceVerificationRequirements | Có | 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. |
Các lỗi điểm cuối này có thể trả về
401 · 404 · 422