Platitun · API · Documents and payout details · Payout details

Payout details

PUT /api/v1/papers/payout

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

Where the marketplace pays you. The account is verified by a checksum AGAINST THE BANK CODE — not “looks like an account” but actually matches the bank. The response repeats only the last four digits: a leaked response must not become leaked banking details.

Phone-based instant payments are for the self-employed only: an LLC or a sole trader is paid to a bank account.

Request fields

Field	Type	What it is
`method` required	`string`	“account” — a bank account, “sbp” — instant payments by phone.
`account`	`string`	The account number, twenty digits.
`bik`	`string`	The bank code, nine digits.
`name`	`string`	The recipient as at the bank.
`kpp`	`string`	Required for an LLC, nine digits.
`phone`	`string`	For instant payments: a phone like 79991234567.

Response fields

Field	Type	What it is
`method`	`string`	What was recorded.
`accountTail`	`string\|null`	The last four digits of the account.
`filled`	`boolean`	Whether the details suffice for a payout.

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
`sbp_only_self`	Phone-based instant payments are for the self-employed only: a company or a sole trader is paid to a bank account.
`phone_format`	The phone must look like 79991234567 — eleven digits starting with a seven.
`bik_bad`	The bank code is invalid: nine digits with its own internal rule.
`account_bad`	The account does not pass the checksum WITH THIS bank code. This is not “looks like an account” — it is a check against the bank.
`name_needed`	A recipient is required — exactly as recorded at the bank.
`kpp_bad`	A company must provide a KPP: nine digits.

Nearby in this section

GET /api/v1/papers — My seller admission
PUT /api/v1/papers/nickname — The seller nickname
POST /api/v1/papers/offer — Accept the seller offer
PUT /api/v1/papers/status — Status and tax number
POST /api/v1/papers/registry-confirm — Confirm the name