Platitun · API · Документы и реквизиты · Свой порог продавца

Свой порог продавца

GET /api/v1/papers

Область ключа: documents · только чтение

Что заполнено и что мешает выйти на витрину: ник, оферта, статус с ИНН, сверка наименования по реестру, реквизиты выплат. Номер счёта отдаётся только последними четырьмя знаками.

Тестовой учётной записи бумаги не нужны: у неё порог считается закрытым без документов — ровно для этого признак и заведён.

Поля ответа

Поле	Тип	Что это
`nickname`	`string\|null`	Ник, который видит покупатель.
`sellerType`	`string\|null`	ooo, ip или self_employed.
`inn`	`string\|null`	Налоговый номер, как он записан.
`offerAcceptedAt`	`string\|null`	Когда принята оферта продавца.
`registry`	`object`	Сверка с реестром: найденное наименование, когда проверяли, подтверждено ли, и код причины, если не сошлось.
`payout`	`object`	Реквизиты: способ, последние четыре знака счёта, БИК, получатель, заполнено ли всё.
`listable`	`boolean`	Пускают ли карточки на витрину прямо сейчас.

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

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

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

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

PUT /api/v1/papers/nickname — Ник продавца
POST /api/v1/papers/offer — Принять оферту продавца
PUT /api/v1/papers/status — Статус и налоговый номер
POST /api/v1/papers/registry-confirm — Подтвердить наименование
PUT /api/v1/papers/payout — Реквизиты выплат