marketplace

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

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

Wszystkie dokumentacje dla programistów →

Uwierzytelnianie

Wyślij klucz API jako token bearer. Ten punkt końcowy nie określa konkretnego uprawnienia w specyfikacji, więc nadaj swojemu kluczowi minimum potrzebnych uprawnień i sprawdź odpowiedź zamiast zakładać.

Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

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

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

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.

Parametry

Nazwa	Typ	Wymagane	Co to jest
`sale_id (path)`	`string`	Tak	—

Treść żądania

Nazwa	Typ	Wymagane	Co to jest
`reason`	`string`	Tak	—

Odpowiedź

Nazwa	Typ	Wymagane	Co to jest
`sale_id`	`string`	Tak	—
`state`	`string`	Tak	—
`is_buyer`	`boolean`	Tak	—
`can_raise`	`boolean`	Tak	—
`refusal_code`	`object`	Tak	—
`dispute`	`object`	Tak	—

Błędy, które ten punkt końcowy może zwrócić

401 · 404 · 422

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