Platitun · API · The deal · Answer a dispute

Answer a dispute

POST /api/v1/orders/{id}/dispute/reply

Key scope: orders · changes data, the Idempotency-Key header is required

A dispute is opened by the buyer. Your answer is either agreement with the claim (then the money is refunded at once) or an objection with an explanation. Twelve hours of silence closes the dispute with a refund BY ITSELF, and that counts as a lost dispute.

Resolving a dispute as an administrator is not in the API and will not be: that is a human judging someone else’s money. Your answer is here, and it matters more than it seems — silence costs more than a clumsy answer.

Request fields

Field	Type	What it is
`accept` required	`boolean`	true — agree and refund, false — object.
`note`	`string`	An explanation. With an objection there is nothing to judge without it.

Response fields

Field	Type	What it is
`refunded`	`boolean`	Whether the money was refunded to the buyer at once.

Refusal reasons

A rule refusal arrives as {"error":"rejected","refusal":{"kind":"…"}} with status 409. Refusals common to all endpoints are in the rules section.

Code	What happened and what to do
`not_found`	The record does not exist or is not yours. The ownership condition is in the database query itself, so someone else’s record looks like a missing one.
`state_moved`	The order has already moved on: the buyer cancelled, the deadline passed, or the action was done another way. Re-read the order before retrying.
`empty`	Empty text. There is nothing to send.

Nearby in this section

GET /api/v1/orders — My orders
GET /api/v1/orders/{id} — One order
POST /api/v1/orders/{id}/confirm — Take the order
POST /api/v1/orders/{id}/decline — Decline the order
POST /api/v1/orders/{id}/deliver — Mark the delivery
POST /api/v1/orders/{id}/messages — Message the buyer
GET /api/v1/orders/{id}/handover — The order vaults
POST /api/v1/orders/{id}/handover — Put credentials into a vault
POST /api/v1/orders/{id}/handover/reveal — Read the buyer’s vault
GET /api/v1/reviews — Reviews about me
POST /api/v1/reviews/{id}/reply — Reply to a review
GET /api/v1/complaints — My complaints
POST /api/v1/complaints — Complain about a buyer
GET /api/v1/work-mode — Work mode and presence
PUT /api/v1/work-mode — Set the work mode