> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnia-voice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Auto-reload

> Automatically top up your wallet so production never stalls.

Auto-reload keeps your wallet funded without manual top-ups. When your balance
drops below a threshold you set, Omnia charges a saved card and credits your
wallet, off-session, without you present. For any production workload, this
removes the failure mode where a wallet hitting zero starts returning
`402 insufficient_balance`.

## How it works

<Steps>
  <Step title="Save a card">
    Do one normal top-up in the dashboard. That payment saves the card for
    future off-session charges (via Stripe's `setup_future_usage`; Omnia never
    stores card numbers). This is the prerequisite for auto-reload: a card must
    be on file before it can charge automatically.
  </Step>

  <Step title="Set a threshold and amount">
    In **Usage → Auto-reload**, set the **balance threshold** that triggers a
    top-up and the **amount** to add each time.
  </Step>

  <Step title="Let it run">
    Whenever your balance falls **below the threshold after a charge**, Omnia
    charges the saved card off-session for your configured amount and credits
    the wallet.
  </Step>
</Steps>

## Choosing a threshold

The threshold is evaluated after each charge, so set it high enough to cover the
traffic between the moment your balance dips below it and the moment the reload
lands. Base it on your spend rate: a workspace burning a few dollars a minute
wants a higher threshold than one spending pennies an hour.

<Tip>
  Think of the threshold as your low-water mark and the amount as your refill
  size. A larger amount means fewer reload charges; a higher threshold means more
  headroom before you'd ever approach the `402` buffer.
</Tip>

## Safeguards

<AccordionGroup>
  <Accordion title="Idempotent: no double-charging">
    Auto-reload charges are **idempotent**. A trigger firing twice in quick
    succession won't charge your card twice or double-credit the wallet.
  </Accordion>

  <Accordion title="Soft decline on extra authentication">
    Some charges require extra authentication (for example, 3-D Secure), which
    needs you present and therefore **can't complete off-session**. Omnia treats
    this as a **soft decline**: it pauses auto-reload rather than retry-looping,
    and prompts you to top up manually (or re-authorize the card) so the wallet
    isn't left silently draining.
  </Accordion>
</AccordionGroup>

<Warning>
  If auto-reload is paused after a soft decline, your wallet will not refill on its
  own. Top up manually to restore service and re-enable auto-reload.
</Warning>

## Related

<CardGroup cols={2}>
  <Card title="Managing your wallet" icon="wallet" href="/billing/wallet">
    Top up, track balance, and understand holds.
  </Card>

  <Card title="Usage & invoices" icon="receipt" href="/billing/usage">
    See recent top-ups and per-request costs.
  </Card>
</CardGroup>