marketplace

GET `/v1/marketplace/orders/{sale_id}`

The order workspace — one order, from your side of it.

Ìfàṣẹ́pọ̀

Fi bọ́kì kọ́kọ́ (bearer token) ránṣẹ́ gẹ́gẹ́ bí àmì ìdánimọ̀ API. Ibùdó yìí kò sọ àṣẹ pàtó kan nínú àlàyé rẹ̀, nítorí náà fún kọ́kọ́ rẹ̀ ní ohun tó kéré jù lọ tí ó nílò kí o sì ṣàyẹ̀wò ìdáhùn náà dípò kí o kàn rò ó.

Ojú abánisọ̀rọ̀ yìí kò gba id ajọ kankan. Kọ́kọ́rọ́ rẹ ti mọ ajọ ti o jẹ ti e, a o si fèsì nipa rẹ̀.

Gbiyanju rẹ

Rọ́pọ̀ èyíkéyìí nínú àwọn àmì ìtọ́ka < > pẹ̀lú iye tirẹ̀, àti àmì ìdánimọ̀ bọ́tìnnì náà pẹ̀lú bọ́tìnnì kan láti inú dásibọ̀ọ̀dù rẹ.

curl -X GET https://api.zinndigital.com/v1/marketplace/orders/{sale_id} \
  -H "Authorization: Bearer zdk_live_…"

Ṣé o ti wọlé? Iwọ̀n api ní nú ìgbékalẹ̀ rẹ kún id àjọ gidi rẹ ati bọtini tirẹ, o si nṣiṣẹ ibeere na lòdì si api gidi ki o le rii esi gidi na. Ṣí ojú abáná yìí sílẹ̀ nínú kọnsólù API

Àwọn kúlẹ̀kúlẹ̀

docs/147 §3. The screen where the work actually happens, for whichever party is asking. Before this there was a buyer's list and a seller's money screen, and nowhere the work happened. The payload leads with `turn` and `waiting_on` because the screen does. The anti-jumble device is one question at the top — **whose turn is it, and what is it waiting for** — and it is computed in the engine so every client answers it identically rather than each deriving it from six columns. `paused` is the revision clock, made visible. Requesting a revision pauses the acceptance window by clearing its deadline, which is correct and completely unrenderable: a null deadline looks identical to a sale that never had one. The commission split is present for the SELLER and null for the buyer. To a buyer the price is the price.

Àwọn ìpìlẹ̀

Orúkọ	Iru	Tí a nílò	Kini o jẹ
`sale_id (path)`	`string`	Bẹẹni	—

Idahun

Orúkọ	Iru	Tí a nílò	Kini o jẹ
`sale_id`	`string`	Bẹẹni	—
`state`	`string`	Bẹẹni	—
`archetype`	`MarketplaceOrderArchetype`	Bẹẹni	How this order behaves. Adding a CATEGORY is configuration; adding an ARCHETYPE is a build. Every order-side decision — whether a delivery clock exists, whether auto-accept appl…
`listing_title`	`string`	Bẹẹkọ	—
`package_name`	`string`	Bẹẹkọ	—
`turn`	`MarketplaceOrderTurn`	Bẹẹni	Whose move it is. `staff` is a real answer, not a fallback: a disputed order is genuinely waiting on us, and telling a buyer "waiting for the seller" while a moderator holds it…
`waiting_on`	`MarketplaceOrderWaitingOn`	Bẹẹni	What the order is waiting FOR — the half that makes `turn` actionable.
`is_yours`	`boolean`	Bẹẹkọ	Whether the caller is the party being waited on.
`is_buyer`	`boolean`	Bẹẹni	—
`deadline`	`string`	Bẹẹkọ	The clock that is actually running, or null when none is.
`paused`	`boolean`	Bẹẹkọ	A clock EXISTS but is stopped — the revision pause. Distinct from a null deadline, which also covers an order that never had a clock at all.
`overdue`	`boolean`	Bẹẹkọ	Never true while `delivery_due_at` is null: null means the clock has not started, which is exactly the state of an order whose buyer has not written their brief yet.
`handover_confirmed`	`integer`	Bẹẹkọ	—
`handover_required`	`integer`	Bẹẹkọ	—
`outstanding`	`string[]`	Bẹẹkọ	Question keys the buyer still owes.
`revisions_used`	`integer`	Bẹẹkọ	—
`revisions_included`	`integer`	Bẹẹkọ	—
`delivery_due_at`	`string`	Bẹẹkọ	—
`currency`	`string`	Bẹẹkọ	—
`gross_minor`	`integer`	Bẹẹkọ	Integer minor units. Money is never a float.
`commission_minor`	`integer`	Bẹẹkọ	The platform's commission, as its own figure. Present for the SELLER and null for the buyer — to a buyer the price is the price. The platform is merchant of record on every mark…
`vendor_net_minor`	`integer`	Bẹẹkọ	What we owe the seller — a trade payable, not money held on trust.
`requirements_schema`	`object[]`	Bẹẹkọ	The questions AS ASKED, frozen at purchase. A seller who rewrites their questions tomorrow cannot change what this buyer was asked.
`requirements`	`object`	Bẹẹkọ	The buyer's answers, in the same `{key: {v: …}}` envelope.
`requirements_submitted_at`	`string`	Bẹẹkọ	—
`handover_items`	`MarketplaceHandoverItem[]`	Bẹẹkọ	—
`last_revision_reason`	`string`	Bẹẹkọ	—

Awọn aṣiṣe ti ibudo ipari yii le da pada

401 · 404

GET /v1/marketplace/orders/{sale_id}