marketplace

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

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

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

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/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.

Mga Parameter

Pangalan	Uri	Kailangan	Ano ito
`sale_id (path)`	`string`	Oo	—
`item_id (path)`	`string`	Oo	—

Katawan ng kahilingan

Pangalan	Uri	Kailangan	Ano ito
`action`	`string<transferred, confirm, flag>`	Oo	`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`	Hindi	The seller's evidence, the buyer's note, or — on `flag` — the required reason.

Tugon

Pangalan	Uri	Kailangan	Ano ito
`item`	`MarketplaceHandoverItem`	Oo	—
`confirmed`	`integer`	Oo	—
`required`	`integer`	Oo	—
`order_accepted`	`boolean`	Oo	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`	Oo	—

Mga error na maibabalik ng endpoint na ito

401 · 404 · 422

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