Platitun · API · Documents and payout details · Confirm the name
Confirm the name
POST /api/v1/papers/registry-confirmKey scope: documents · changes data, the Idempotency-Key header is required
You confirm that the name found in the registry is yours. Until then the admission is incomplete. Change the number and you confirm again: otherwise someone else’s name would count as confirmed from last time.
Response fields
| Field | Type | What it is |
|---|---|---|
confirmed | boolean | Confirmed. |
already | boolean | It was already confirmed: a repeat is not an error, but not a new event either. |
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 |
|---|---|
registry_nothing_to_confirm | There is nothing to confirm: no registry name has been found yet. Set the status and the number first. |
Nearby in this section
GET /api/v1/papers— My seller admissionPUT /api/v1/papers/nickname— The seller nicknamePOST /api/v1/papers/offer— Accept the seller offerPUT /api/v1/papers/status— Status and tax numberPUT /api/v1/papers/payout— Payout details