Platitun · API · Документы и реквизиты · Реквизиты выплат

Реквизиты выплат

PUT /api/v1/papers/payout

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

Куда площадка платит. Счёт проверяется контрольной суммой ПО БИК — не «похож на счёт», а сходится с банком. Ответ повторяет только последние четыре знака: утечка ответа не должна становиться утечкой реквизитов.

Быстрые платежи по телефону — только самозанятому: у ООО и ИП выплата идёт на расчётный счёт.

Поля запроса

Поле	Тип	Что это
`method` обязательно	`string`	«account» — расчётный счёт, «sbp» — быстрые платежи по телефону.
`account`	`string`	Номер счёта, двадцать знаков.
`bik`	`string`	Код банка, девять знаков.
`name`	`string`	Получатель, как в банке.
`kpp`	`string`	Для ООО обязателен, девять знаков.
`phone`	`string`	Для быстрых платежей: телефон вида 79991234567.

Поля ответа

Поле	Тип	Что это
`method`	`string`	Что записано.
`accountTail`	`string\|null`	Последние четыре знака счёта.
`filled`	`boolean`	Хватает ли реквизитов для выплаты.

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

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

Код	Что случилось и что делать
`sbp_only_self`	Быстрые платежи по телефону доступны только самозанятому: у организации и предпринимателя выплата идёт на расчётный счёт.
`phone_format`	Телефон должен быть вида 79991234567 — одиннадцать цифр, начиная с семёрки.
`bik_bad`	Код банка не годен: девять цифр и своё внутреннее правило.
`account_bad`	Счёт не сходится по контрольной сумме С ЭТИМ кодом банка. Это не «похож на счёт» — это проверка вместе с банком.
`name_needed`	Нужен получатель — так, как он записан в банке.
`kpp_bad`	У организации обязателен КПП: девять цифр.

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

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