Platitun · API · Сделка · Ответить в споре

Ответить в споре

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

Область ключа: orders · изменяет данные, нужен заголовок Idempotency-Key

Спор открывает покупатель. Ваш ответ — либо согласие с претензией (тогда деньги возвращаются сразу), либо возражение с объяснением. Молчание двенадцать часов закрывает спор возвратом САМО, и это считается проигранным спором.

Решение спора администратором в API нет и не будет: это разбор чужих денег человеком. Ваш ответ есть, и он важнее, чем кажется, — молчание стоит дороже неудачного ответа.

Поля запроса

Поле	Тип	Что это
`accept` обязательно	`boolean`	true — согласиться и вернуть деньги, false — возразить.
`note`	`string`	Объяснение. При возражении без него разбирать нечего.

Поля ответа

Поле	Тип	Что это
`refunded`	`boolean`	Вернулись ли деньги покупателю сразу.

Поводы отказа

Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.
`state_moved`	Заказ уже ушёл дальше: покупатель отменил, срок вышел или действие сделано другим способом. Перечитайте заказ, прежде чем повторять.
`empty`	Пустой текст. Отправлять нечего.

Рядом в этом разделе

GET /api/v1/orders — Свои заказы
GET /api/v1/orders/{id} — Один заказ
POST /api/v1/orders/{id}/confirm — Взять заказ
POST /api/v1/orders/{id}/decline — Отказаться от заказа
POST /api/v1/orders/{id}/deliver — Отметить выдачу
POST /api/v1/orders/{id}/messages — Написать покупателю
GET /api/v1/orders/{id}/handover — Сейфы заказа
POST /api/v1/orders/{id}/handover — Положить доступ в сейф
POST /api/v1/orders/{id}/handover/reveal — Прочитать сейф покупателя
GET /api/v1/reviews — Отзывы о себе
POST /api/v1/reviews/{id}/reply — Ответить на отзыв
GET /api/v1/complaints — Свои жалобы
POST /api/v1/complaints — Пожаловаться на покупателя
GET /api/v1/work-mode — Режим работы и присутствие
PUT /api/v1/work-mode — Задать режим работы