marketplace

POST `/v1/marketplace/orders/{sale_id}/handover/{item_id}`

Tick one handover item — from your side of the order.

Hitelesítés

Küldjön egy API-kulcsot bearer tokenként. Ez a végpont nem határoz meg konkrét jogosultságot a specifikációban, ezért adja meg a kulcsnak a legkevesebbet, amire szüksége van, és a feltételezés helyett ellenőrizze a választ.

Ez a végpont nem fogad el szervezeti azonosítót. Az Ön kulcsa már azonosítja azt a szervezetet, amelyhez tartozik, és a válasz is erre vonatkozik.

Próbálja ki

Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.

curl -X POST https://api.zinndigital.com/v1/marketplace/orders/{sale_id}/handover/{item_id} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "action": <string<transferred, confirm, flag>> }'

Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban

Részletek

docs/83 §4.4. Each item carries **two** confirmations: the seller marks it transferred, and the buyer marks it received. Funds release only when every required item is buyer-confirmed — a seller-only tick is not delivery. Which action a caller may take is decided server-side by which side of the order they are on. A seller marking an item received on the buyer's behalf would be a seller releasing their own money. A buyer can flag a single item as missing or wrong **without rejecting the whole sale**; that flag is what opens a dispute, with the checklist and the order chat as evidence. `order_accepted` is true when this tick was the last required one and the money has been released.

Paraméterek

Név	Típus	Kötelező	Mi ez
`sale_id (path)`	`string`	Igen	—
`item_id (path)`	`string`	Igen	—

Kérés törzse

Név	Típus	Kötelező	Mi ez
`action`	`string<transferred, confirm, flag>`	Igen	`transferred` is the seller's only action; `confirm` and `flag` are the buyer's. Enforced server-side — a seller marking an item received on the buyer's behalf would be a seller…
`note`	`string`	Nem	The seller's evidence, the buyer's note, or — on `flag` — the required reason.

Válasz

Név	Típus	Kötelező	Mi ez
`item`	`MarketplaceHandoverItem`	Igen	—
`confirmed`	`integer`	Igen	—
`required`	`integer`	Igen	—
`order_accepted`	`boolean`	Igen	True when this tick was the last required one and the money has been released. Reported because the buyer's last tick is the most consequential moment of the order and a screen…
`state`	`string`	Igen	—

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 404 · 422

POST /v1/marketplace/orders/{sale_id}/handover/{item_id}