Platitun · API · Сделка · Отметить выдачу

Отметить выдачу

POST /api/v1/orders/{id}/deliver

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

Товар выдан. У подписки и аккаунта с подпиской ОБЯЗАТЕЛЬНА дата следующего списания: это доказательство активации, и покупатель проверяет его за секунды. Без неё выдача не принимается.

Смотрите noteRejected: выдача прошла, но покупатель примечания не увидел. Молча оставить это — значит оставить его без объяснения.

Поля запроса

Поле	Тип	Что это
`nextChargeDay`	`string`	Дата следующего списания у вендора, вида 2026-09-20. Обязательна у подписки и аккаунта с подпиской.
`note`	`string`	Примечание покупателю: что он получил и что делать дальше.

Поля ответа

Поле	Тип	Что это
`status`	`string`	Состояние после выдачи.
`noteRejected`	`string\|null`	Выдача состоялась, а примечание НЕ прошло проверку на контакты. Перепишите его без контактов и отправьте сообщением.

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

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

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

Пример

POST /api/v1/orders/cmt2x34ms001boz019p80jgzn/deliver
Idempotency-Key: deliver-1042-once

{ "nextChargeDay": "2026-09-20", "note": "Подписка активна, продление автоматическое." }

→ 200 { "order": "cmt2…", "status": "delivered", "noteRejected": null }

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

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}/messages — Написать покупателю
GET /api/v1/orders/{id}/handover — Сейфы заказа
POST /api/v1/orders/{id}/handover — Положить доступ в сейф
POST /api/v1/orders/{id}/handover/reveal — Прочитать сейф покупателя
POST /api/v1/orders/{id}/dispute/reply — Ответить в споре
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 — Задать режим работы