Platitun · API · Documents and payout details · Status and tax number

Status and tax number

PUT /api/v1/papers/status

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

The company name is NOT accepted from the request at all: the marketplace fetches it from the registry by the number and you confirm it is you. That catches both a mistyped digit and someone else’s number.

A seller blocked or suspended by an administrator does NOT lift it themselves — neither by button nor by program: the registry confirms a company exists, not the right to trade here.

For an ALREADY WORKING seller a failed check does NOT touch the previous data: the refusal carries keptPrevious=true, trading continues and a request goes to an administrator. One mistyped digit must not cost you the storefront.

Request fields

Field	Type	What it is
`sellerType` required	`string`	ooo, ip or self_employed.
`inn` required	`string`	The tax number: ten digits for an LLC, twelve for the rest. Verified by checksum.

Response fields

Field	Type	What it is
`registryName`	`string`	The name found in the registry.
`needsConfirm`	`boolean`	Whether the name needs confirming. Until it is confirmed the admission is incomplete and your stock will not reach the storefront.

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
`choose_status`	The status must be one of: ooo, ip, self_employed.
`inn_bad_ooo`	A company tax number is ten digits and must pass its checksum.
`inn_bad_person`	A personal tax number is twelve digits and must pass its checksum.
`blocked_cannot_self_restore`	A seller blocked or suspended by an administrator does not lift it themselves. Contact support.
`registry_failed`	The registry check did not match. The refusal names the reason and, if the record is closed, its date. For an already working seller the previous data is preserved — see keptPrevious.

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
POST /api/v1/papers/registry-confirm — Confirm the name
PUT /api/v1/papers/payout — Payout details