marketplace

POST `/v1/marketplace/orders/{sale_id}/dispute`

The buyer disputes an order — stops the acceptance clock and holds the payout.

Аутентификација

Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X POST https://api.zinndigital.com/v1/marketplace/orders/{sale_id}/dispute \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "reason": <string> }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

Buyer only (a seller receives 404). A reason is required. The sale moves to disputed, the auto-accept deadline is cleared, no path can release the seller's payable until staff decide, and the seller, the buyer and marketplace staff are notified.

Параметри

Назив	Тип	Обавезно	Шта је ово
`sale_id (path)`	`string`	Да	—

Тело захтева

Назив	Тип	Обавезно	Шта је ово
`reason`	`string`	Да	—

Одговор

Назив	Тип	Обавезно	Шта је ово
`sale_id`	`string`	Да	—
`state`	`string`	Да	—
`is_buyer`	`boolean`	Да	—
`can_raise`	`boolean`	Да	—
`refusal_code`	`object`	Да	—
`dispute`	`object`	Да	—

Грешке које ова крајња тачка може вратити

401 · 404 · 422

POST /v1/marketplace/orders/{sale_id}/dispute