1. Введение
LarpCassa API позволяет интегрировать платёжные функции в ваши сервисы: создавать платежи, проверять и отменять их, получать баланс и выводить средства. Подходит для сайтов, Telegram-ботов и приложений.
Все запросы выполняются в формате JSON по протоколу HTTPS. Суммы — целые числа в копейках (100000 = 1 000 ₽), валюта — RUB, даты — ISO 8601 (UTC).
Базовый URL:
https://larpcassa.cc/v12. Авторизация
Для работы с API в заголовки запросов (headers) нужно передать ключ проекта.
| Key | Value |
|---|---|
| X-Api-Key | <Ваш API-ключ> |
| Content-Type | application/json |
Ключ создаётся в кабинете, раздел «API и интеграция». Секрет показывается один раз.
bash
curl https://larpcassa.cc/v1/balance \ -H "X-Api-Key: lc_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
3. Тестовая и боевая среда
| Ключ | Среда |
|---|---|
lc_test_… | Sandbox — платежи и выплаты симулируются, реальных денег нет |
lc_live_… | Production — реальные операции (после модерации проекта) |
Данные сред полностью разделены: платежи, балансы и получатели Sandbox не видны в Production и наоборот.
4. Идентификатор запроса
Каждый ответ содержит заголовок x-request-id. Укажите его при обращении в поддержку — так мы быстрее найдём ваш запрос.