API: sold, licențe, retrageri și facturi

LanaChat se plătește dintr-un sold preplătit în dolari americani: din acesta se scad licențele (una per cont Telegram, 30 de zile) și o comision din vânzările nete. Îl reîncarci cu depozite în criptomonede. Câștigurile din afiliere pot fi retrase. Fiecare endpoint de facturare necesită un token de owner: în exemple, $LANACHAT_TOKEN deține unul.

Endpoints #

Prețuri într-un tabel #

Contorul este vânzarea netă a întregului workspace în luna calendaristică; se resetează pe 1. Telegram Stars contează ca $0.013 fiecare în vânzări nete.

Obiectul sold #

{
  "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
}

Ratele sunt în puncte de bază: 1200 înseamnă 12%.

Obiectul intrării în registru #

Fiecare linie din Billing › Activity în Console.

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

O linie commission aparține unei vânzări: Console arată fanul, nivelul, cine a trimis oferta (AI sau manual), cum s-a calculat netul ("12,500 ★ × $0.013") și rata.

Obiectul depozitului #

{
  "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 pe Ethereum este creditat 1:1 fără taxă. Orice alt blockchain are o taxă de 1%: depozitul se convertește în USDC (ERC20) la sosire. Minim $25 per reîncărcare.

Obiectul licenței #

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

Licențele din stoc sunt numărate, nu listate individual: fiecare păstrează zilele rămase (30 pentru una nouă).

Obiectul retragerii #

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

Obiectul facturii #

{
  "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"
}

Sold și registru #

Obține soldul #

GET /billing/balance · owner

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

Răspunsul este obiectul sold.

Listează registrul #

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"
}

Exportă registrul ca 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

Aceleași linii ca la Export CSV în Billing › Activity, gata pentru contabilul tău.

Depozite #

Obține adresele de depozit #

GET /billing/deposit-addresses · owner

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

Răspunsul oferă o adresă per blockchain (Ethereum, Solana, Tron) și, pentru Solana, memo-ul.

Poți trimite USDC pe Ethereum (ERC20), USDC pe Solana, USDT pe Solana, USDT pe Tron (TRC20) sau USDT pe Ethereum (ERC20). Taxa de rețea a transferului este plătită din portofelul tău.

Listează depozitele #

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
}

Soldul este creditat automat când un depozit este confirmed; acesta devine și o linie deposit în registru.

Licențe #

Listează licențele #

GET /billing/licences · owner

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

Răspunsul oferă licențele în stoc și un obiect licență per cont atribuit, cu zilele rămase.

Cumpără licențe #

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" }

Licențele intră imediat în stocul tău. Un sold prea mic răspunde cu 402 (insufficient_balance). Licențele în stoc nu expiră niciodată, iar cele cumpărate nu sunt rambursabile.

Atribuie o licență #

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"}'

Răspunsul este obiectul licență al contului. Licența din stoc cu cele mai puține zile rămase este folosită prima: zilele rămase ale acesteia sau 30 dacă e nouă. Reînnoirea automată este activată implicit.

Ia o licență înapoi #

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"}'

Licența revine în stoc cu zilele rămase. AI încetează să răspundă pe acel cont imediat. Pentru a muta o licență la alt cont, ia-o înapoi, apoi atribuie-o: păstrează zilele, gratuit.

Activează sau dezactivează reînnoirea automată #

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}'

Când zilele expiră, reînnoirea automată ia mai întâi o licență din stoc sau cumpără o licență individuală ($19) dacă stocul este gol. Nu poate cumpăra fără sold: urmărește low_balance sau webhook-ul billing.low_balance webhook.

Retrageri din afiliere #

Listează retragerile #

GET /billing/withdrawals · owner

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

O listă de obiecte retragere, cele mai noi primele.

Cere o retragere #

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 }

Câștigurile sunt trimise în USDC către portofelul înregistrat, la 7 zile după încheierea lunii. Se pot retrage doar câștigurile din afiliere, niciodată soldul preplătit. Cererile sub $500 sunt refuzate.

Declarații #

Listează declarațiile #

GET /billing/invoices · owner

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

Un obiect factură per lună.

Descarcă o declarație #

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

Setează detaliile de facturare #

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"}'

Aceleași câmpuri ca în Billing › Billing details. Declarațiile conțin aceste detalii. PUT le înlocuiește pe toate: un câmp omis este golit.