Plateshka
APIСчета

Создать счёт

Передавайте либо `method`, либо `methods` — вместе они запрещены. Сумма всегда строка целых минорных единиц: `«149900»` это 1499,00 ₽.

POST/v1/invoices

Передавайте либо method, либо methods — вместе они запрещены. Сумма всегда строка целых минорных единиц: «149900» это 1499,00 ₽.

АвторизацияBearer <token>

Заголовок Authorization: Bearer <ключ>, например Authorization: Bearer plt_ExampleKeyDoNotUseExampleKeyDoNotUse01. Название схемы сравнивается без учёта регистра. Ключ начинается с plt_; храним мы только его SHA-256, поэтому потерянный ключ не восстанавливается — он перевыпускается.

In: header

Заголовки

Idempotency-Key*string

Ключ повтора. Тот же ключ с тем же телом не выполняет операцию заново: возвращается сохранённый ответ и код 200 вместо 201. Живёт 24 часа.

Length1 <= length <= 255

Тело запроса

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Тело создания счёта.

Тело ответа

application/json

application/json

curl -X POST "https://example.com/v1/invoices" \  -H "Idempotency-Key: order-4815162342" \  -H "Content-Type: application/json" \  -d '{    "amount": {      "amount": "149900",      "currency": "RUB"    }  }'
{  "id": "9f1d4c02-3b7a-4c1e-8a55-6a1c2d3e4f50",  "status": "created",  "amount": {    "amount": "149900",    "currency": "RUB"  },  "description": "Подписка «Про», 1 месяц",  "comment": null,  "customer": {    "email": "[email protected]",    "phone": null,    "externalId": "user-7781"  },  "metadata": {    "orderId": "4815162342"  },  "paymentUrl": "https://pay.example.com/i/9f1d4c02-3b7a-4c1e-8a55-6a1c2d3e4f50",  "returnUrl": "https://shop.example.com/orders/4815162342",  "method": null,  "pinnedMethod": "sbp",  "createdAt": "2026-08-19T10:15:30Z",  "expiresAt": "2026-08-20T10:15:30Z",  "paidAt": null}