Platitun · API · The deal · Message the buyer

Message the buyer

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

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

A message in the order chat. Contact details do not pass: taking the deal off the marketplace strips the buyer of protection and the seller of the guarantee, and a repeat attempt affects the rating.

The chat closes with the order: for a finished order it stays READABLE but you cannot write into it — you will get chat_read_only.

Request fields

Field	Type	What it is
`body` required	`string`	The message text.

Response fields

Field	Type	What it is
`ok`	`boolean`	The message is sent.

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.
`empty`	Empty text. There is nothing to send.
`contacts`	Contact details were found in the text — an email, a phone number, a messenger link. Taking the deal off the marketplace strips the buyer of protection and the seller of the guarantee. Remove them and send again.
`chat_closed`	The chat of this order is closed.
`chat_read_only`	The order is finished: the chat stays readable but you can no longer write into it.

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
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
POST /api/v1/orders/{id}/dispute/reply — Answer a dispute
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