# Latchbell AI credits and money
Read https://latchbell.com/business.md first.

Reading a file, updating what it knows, rewriting the page and each answer the AI gives in a chat take about 1 AI credit from the plan's monthly allowance (every plan includes a monthly allowance; setting a business up takes 10 to 30). When it's used up, new work waits rather than fails: a source shows `queued` with the reason, and `GET receptionist_service` shows `ai.can_spend: false`. Tell the owner their choices: a top-up (`ai.top_ups`: $1, $3, $5, $10 or $100, paid once, never expiring; each pack shows its `ai_credits`, and on a plan that answers calls its `minutes` too, 80% of the pack), upgrading, raising the spending cap on a paid plan, or waiting for `ai.resets_at`. For a top-up they pick: `POST receptionist_top_up {"credits": 1000, "owner_approved": true}` (credits are the pack in cents: 100, 300, 500, 1000, 10000) and open its `url` for them, where they pay in Stripe; then `POST receptionist_refresh {}` and check `ai.top_up_left`. Waiting files are read again by themselves.

Money: `GET receptionist_service` for usage and AI credits; `POST receptionist_limits` only to the amount the owner names (never to make room for a checkout: `receptionist_checkout` sets the cap to the plan price once paid); `POST cancel_receptionist_checkout {}` drops an unpaid plan checkout; `POST receptionist_billing_portal {}` for their invoices and card.
