Skip to content
Ileen Docs

Managing Your Credit Balance

Ileen uses a prepaid credit system. You buy credits upfront and they are consumed as AI agents run. There are no subscriptions or commitments — your balance never expires.

Credit basics

ConceptValue
1 credit€1 (before tax)
Minimum top-up€5
Maximum per purchase€500
ExpiryNever
BillingStripe Invoice with automatic VAT (EU tax compliance)

Credits are deducted after each LLM call — you are never charged for a call that didn’t complete.

Buying credits

From the billing gate (first time)

After your first login, Ileen presents a Billing Gate before you can access the app:

  1. Add a payment method — click the prompt to open the Stripe Customer Portal and add a card.
  2. Buy initial credits — choose €5, €10, €25, €50, or €100.

Both steps must be completed to access the platform.

Subsequent top-ups

  1. Click your user menu (bottom of the sidebar) → Credits & Billing.
  2. The Subscription modal shows your current balance and total credits used.
  3. Under Buy credits, choose an amount and click Purchase.
  4. Credits are added to your balance immediately.

Credit consumption by mode

All four modes consume credits; the rate depends on the complexity of each agent’s task.

ModeWhen credits are consumed
🎨 DesignArchitect chat, plan generation, Tech Leader architecture, milestone and task generation
💻 DevelopCodebase indexing, Code Query answers, Prompt Engineer, each Task Queue execution
📝 ContentSocial post generation, general content generation, content review, changelog generation
🚀 DeployDeploy Agent conversation, each deployment gate

Auto-refill

Auto-refill tops up your wallet automatically when your balance drops below a threshold — so you never run out mid-task.

Configuring auto-refill

  1. Open Credits & Billing from the user menu.
  2. Toggle Auto-refill on.
  3. Set the threshold — the balance level that triggers a refill (€10–€5000).
  4. Set the refill amount — how many euros to add when triggered (€5–€500).
  5. Click Save.

Example configuration:

  • Threshold: €20
  • Refill amount: €50
  • Behaviour: whenever your balance drops to €20 or below after an LLM call, Ileen charges your default card €50 and adds 50 credits.

How it works internally

  • The check happens after each LLM call that reduces your balance.
  • A deduplication guard prevents double-charges if two calls complete simultaneously.
  • The threshold is re-checked immediately before charging — if another refill already ran, the charge is skipped.

Payment methods

Manage your cards in the Credits & Billing modal:

  • List — all saved cards shown with last 4 digits and default indicator
  • Add — click Manage in Stripe to open the Stripe Customer Portal and add a new card
  • Remove — click the trash icon next to any non-default card to detach it
  • Default card — the default is used for all purchases and auto-refills; change it in the Stripe portal

Invoices

Every credit purchase creates a Stripe Invoice with automatic VAT applied per EU regulations.

To download any invoice:

  1. Open Credits & Billing → Manage in Stripe.
  2. In the Stripe portal, go to Invoice history.
  3. Click any invoice to download the PDF.

Refunds

Unused credits are refundable on request within 14 days of purchase, in line with EU consumer law.

Contact support with your account email and the purchase date.

Next steps