Начните с первого платежа

Plateshka принимает платёж за ваш заказ и сообщает результат вашему серверу. Ваша интеграция создаёт счёт, открывает покупателю paymentUrl и выдаёт товар только после подтверждённого события.

Когда нужна эта документация

Используйте её, если платёж запускается с сайта, из Telegram-бота или другого серверного приложения. Секретный API-ключ всегда остаётся на вашем сервере: браузер и Telegram Mini App не должны обращаться к API Plateshka напрямую.

Минимальный рабочий путь

1. Получите API-ключ проекта и секрет вебхука в настройках проекта.
2. Создайте счёт через POST /v1/invoices с постоянным Idempotency-Key для заказа.
3. Отправьте покупателя на paymentUrl из ответа.
4. Проверьте подпись вебхука и обработайте invoice.success один раз.

curl -X POST https://api.plateshka.xyz/v1/invoices \
  -H "Authorization: Bearer $PLATESHKA_API_KEY" \
  -H "Idempotency-Key: order-4815162342" \
  -H "Content-Type: application/json" \
  -d '{"amount":{"amount":"149900","currency":"RUB"}}'

Что чаще всего ломается

• Сумму отправляют рублями или числом. API ждёт строку минорных единиц: "149900" — это 1 499,00 ₽.
• По returnUrl считают заказ оплаченным. Этот адрес отвечает только за возврат покупателя.
• При повторе создают новый ключ идемпотентности. Тогда платформа не узнает тот же заказ.
• Вебхук разбирают как JSON до проверки подписи. Подпись рассчитана по исходным байтам тела.

Следующий шаг

Пройдите быстрый старт, затем прочитайте как устроены счета и статусы. Точные поля каждого метода находятся в API.