API: баланс, лицензии, выводы и счета

LanaChat оплачивается с одного предоплаченного баланса в долларах США: с него списываются лицензии (по одной на аккаунт Telegram, 30 дней) и комиссия с чистых продаж. Вы пополняете баланс криптовалютными депозитами. Партнёрские доходы можно выводить. Для каждого биллингового эндпоинта нужен owner токен: в примерах он хранится в $LANACHAT_TOKEN.

Endpoints #

Цены в одной таблице #

Счётчик, это чистые продажи всего рабочего пространства за календарный месяц; сбрасывается 1-го числа. Telegram Stars считаются по $0.013 за штуку в чистых продажах.

Объект баланса #

{
  "balance_cents": 48210,
  "month": "2026-10",
  "net_sales_cents": 1870400,
  "tier": { "up_to_cents": 3000000, "ai_rate_bp": 1200, "manual_rate_bp": 300 },
  "licences": { "in_stock": 4, "assigned": 11, "expiring_7d": 2 },
  "low_balance": false
}

Ставки в базисных пунктах: 1200, это 12%.

Объект записи журнала #

Каждая строка из Billing › Activity в Console.

{
  "id": "led_90211",
  "at": "2026-10-06T14:40:00Z",
  "kind": "licences",
  "label": "Licences · pack of 10",
  "amount_cents": -17000,
  "balance_after_cents": 31210
}

Запись commission относится к одной продаже: Console показывает фаната, уровень, кто отправил оффер (AI или вручную), как считался нетто ("12,500 ★ × $0.013") и ставку.

Объект депозита #

{
  "id": "dep_4",
  "at": "2026-10-06T13:52:00Z",
  "chain": "usdt-tron",
  "sent_cents": 100000,
  "fee_cents": 1000,
  "credited_cents": 99000,
  "status": "pending",
  "confirmations": "12/19"
}

USDC на Ethereum зачисляется 1:1 без комиссии. На остальных цепочках комиссия 1%: депозит конвертируется в USDC (ERC20) при поступлении. Минимум для пополнения, $25.

Объект лицензии #

{
  "account_id": "acc_1001",
  "creator_id": "cr_lea",
  "days_left": 18,
  "expires_at": "2026-10-24T09:00:00Z",
  "auto_renew": true
}

Лицензии на складе считаются, но не перечисляются поштучно: каждая хранит свой остаток дней (30 для новой).

Объект вывода #

{ "id": "wd_118", "status": "pending_review", "amount_cents": 50000, "requested_at": "2026-10-06T15:00:00Z", "tx_hash": null }

Объект счёта #

{
  "id": "LC-2026-09",
  "month": "2026-09",
  "licences_cents": 22800,
  "commission_cents": 930000,
  "total_cents": 952800,
  "status": "paid",
  "pdf_url": "https://api.lanachat.ai/v1/billing/invoices/LC-2026-09.pdf"
}

Баланс и журнал #

Получить баланс #

GET /billing/balance · owner

curl https://api.lanachat.ai/v1/billing/balance \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Ответ, объект баланса.

Список журнала #

GET /billing/ledger · owner

curl "https://api.lanachat.ai/v1/billing/ledger?from=2026-10-01&to=2026-10-06" \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

{
  "data": [
    { "id": "led_90211", "at": "2026-10-06T14:40:00Z", "kind": "licences", "label": "Licences · pack of 10", "amount_cents": -17000, "balance_after_cents": 31210 },
    { "id": "led_90207", "at": "2026-10-06T13:20:00Z", "kind": "commission", "label": "Lea · Marco", "amount_cents": -468, "balance_after_cents": 48210 },
    { "id": "led_90150", "at": "2026-10-05T09:02:00Z", "kind": "deposit", "label": "Deposit · USDC on Ethereum", "amount_cents": 300000, "balance_after_cents": 48678 }
  ],
  "next_cursor": "eyJpZCI6ImxlZF85MDE0OSJ9"
}

Экспорт журнала в CSV #

GET /billing/ledger.csv · owner

curl "https://api.lanachat.ai/v1/billing/ledger.csv?from=2026-09-01&to=2026-09-30" \
  -H "Authorization: Bearer $LANACHAT_TOKEN" -o ledger-2026-09.csv

Те же строки, что и Export CSV в Billing › Activity, готовы для вашего бухгалтера.

Депозиты #

Получить адреса для депозитов #

GET /billing/deposit-addresses · owner

curl https://api.lanachat.ai/v1/billing/deposit-addresses \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Ответ содержит по одному адресу на каждую цепочку (Ethereum, Solana, Tron) и, для Solana, memo.

Вы можете отправлять USDC на Ethereum (ERC20), USDC на Solana, USDT на Solana, USDT на Tron (TRC20) или USDT на Ethereum (ERC20). Комиссия сети оплачивается с вашего кошелька.

Список депозитов #

GET /billing/deposits · owner

curl https://api.lanachat.ai/v1/billing/deposits \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

{
  "data": [
    { "id": "dep_4", "at": "2026-10-06T13:52:00Z", "chain": "usdt-tron", "sent_cents": 100000, "fee_cents": 1000, "credited_cents": 99000, "status": "pending", "confirmations": "12/19" },
    { "id": "dep_3", "at": "2026-10-05T09:02:00Z", "chain": "usdc-eth", "sent_cents": 300000, "fee_cents": 0, "credited_cents": 300000, "status": "confirmed", "confirmations": null }
  ],
  "next_cursor": null
}

Баланс пополняется автоматически при статусе confirmed; это также строка deposit в журнале.

Лицензии #

Список лицензий #

GET /billing/licences · owner

curl https://api.lanachat.ai/v1/billing/licences \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Ответ содержит лицензии на складе и по одной лицензии на каждый назначенный аккаунт с оставшимися днями.

Купить лицензии #

POST /billing/licences/buy · owner

curl -X POST https://api.lanachat.ai/v1/billing/licences/buy \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"pack": 10, "qty": 1}'

{ "licences_added": 10, "amount_cents": 17000, "balance_cents": 31210, "ledger_id": "led_90211" }

Лицензии сразу идут на ваш склад. При недостаточном балансе возвращается 402 (insufficient_balance). Лицензии на складе не истекают, купленные лицензии не подлежат возврату.

Назначить лицензию #

POST /billing/licences/assign · owner

curl -X POST https://api.lanachat.ai/v1/billing/licences/assign \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"account_id": "acc_1001"}'

Ответ, объект лицензии аккаунта. Сначала используется лицензия со склада с наименьшим остатком дней: её оставшиеся дни или 30, если новая. Автообновление включено по умолчанию.

Вернуть лицензию #

POST /billing/licences/unassign · owner

curl -X POST https://api.lanachat.ai/v1/billing/licences/unassign \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"account_id": "acc_1001"}'

Лицензия возвращается на склад с оставшимися днями. AI сразу перестаёт отвечать на этом аккаунте. Чтобы перенести лицензию на другой аккаунт, сначала верните её, затем назначьте заново: она сохранит дни бесплатно.

Включить или выключить автообновление #

PATCH /billing/licences/auto-renew · owner

curl -X PATCH https://api.lanachat.ai/v1/billing/licences/auto-renew \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"account_id": "acc_1001", "auto_renew": false}'

При окончании дней автообновление сначала берёт лицензию со склада или покупает одиночную ($19), если склад пуст. Покупка невозможна без баланса: следите за low_balance или webhook billing.low_balance webhook.

Партнёрские выводы #

Список выводов #

GET /billing/withdrawals · owner

curl https://api.lanachat.ai/v1/billing/withdrawals \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Список объектов вывода, сначала новые.

Запросить вывод #

POST /billing/withdrawals · owner

curl -X POST https://api.lanachat.ai/v1/billing/withdrawals \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 50000}'

{ "id": "wd_118", "status": "pending_review", "amount_cents": 50000, "requested_at": "2026-10-06T15:00:00Z", "tx_hash": null }

Доходы отправляются в USDC на указанный кошелёк через 7 дней после окончания месяца. Выводить можно только партнёрские доходы, а не предоплаченный баланс. Запросы менее $500 отклоняются.

Отчёты #

Список отчётов #

GET /billing/invoices · owner

curl "https://api.lanachat.ai/v1/billing/invoices?year=2026" \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Один объект счёта на месяц.

Скачать отчёт #

GET /billing/invoices/{id}.pdf · owner

curl https://api.lanachat.ai/v1/billing/invoices/LC-2026-09.pdf \
  -H "Authorization: Bearer $LANACHAT_TOKEN" -o LC-2026-09.pdf

Установить данные для биллинга #

PUT /billing/details · owner

curl -X PUT https://api.lanachat.ai/v1/billing/details \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"company": "Mia Agency Ltd", "email": "[email protected]", "address": "12 Market Street", "city": "Dublin", "postal": "D02 X285", "country": "IE", "vat": "IE1234567T"}'

Те же поля, что и в Billing › Billing details. Отчёты содержат эти данные. PUT заменяет все поля: пропущенные очищаются.