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

# Credits, top-ups and invoices

> How KugelAudio credits work: the free starting credit, adding credits, automatic recharge, the monthly spend cap, invoices and VAT, and what to do when a payment fails or your credits run out.

KugelAudio bills usage from a prepaid credit balance per organization. Rates per
model are on the [pricing page](https://www.kugelaudio.com/en/pricing); this
page explains how the balance behaves.

<Note>
  Only organization owners and admins can see and change billing. If your
  organization requires two-factor authentication, billing asks for it too. See
  [Account security](/guides/account-security).
</Note>

## Your starting credit

Every new account gets a one-time free credit, no card needed. The amount and
how far it goes are in the [Quick Start](/quickstart#free-credit-to-start).

## Add credits

Open the billing page of the [dashboard](https://kugelaudio.com/dashboard) and
add credits. A top-up is between €10 and €20,000. Credits are added to the
balance as soon as the payment goes through, and every top-up produces an
invoice.

If you pay as a business and enter a VAT ID at checkout, the purchase is
invoiced as a business purchase.

<Warning>
  Prices on the pricing page are net of VAT. The invoice shows the VAT that
  applies to you.
</Warning>

## Automatic recharge

Instead of topping up by hand you can turn on automatic recharge in billing.
You set the balance at which it triggers and the amount to add, and an optional
monthly limit on what it may charge. It charges your saved payment method.

## Monthly spend cap

Billing also has a monthly spend cap. When the month's cap is reached,
requests are refused with the same `402` [`INSUFFICIENT_CREDITS`](/api-reference/errors)
as an empty balance, even if credits are left. The dashboard banner says which
it is: "This month's spend cap is reached." Raise the cap, or wait for the next
month. Adding credits does not help in this case.

## Invoices and receipts

Each top-up creates an invoice with a download link (PDF) and a hosted invoice
page. You find them under recent invoices on the billing page. Payment
confirmations and invoices are also sent by email; you choose which emails you
get under Account settings → Email notifications ("Billing and invoices").

## When requests are refused with 402

`402` [`INSUFFICIENT_CREDITS`](/api-reference/errors) (close code `4003` on a
WebSocket) means one of two things: the credit balance is used up, or the
[monthly spend cap](#monthly-spend-cap) is reached. The dashboard banner tells
which ("Your credit balance is used up" or "This month's spend cap is
reached"). For an empty balance, add credits; for the cap, raise it. Requests
work again right after. Organization owners and admins get one email when the
credits run out.

## When a payment fails

| What you see | What it means | What to do |
|---|---|---|
| A banner "Your last payment failed" | The last charge was declined or needs your confirmation. | Choose **Update payment** and pay again, or use another method. |
| A banner "Auto recharge is paused" and an email | Your saved payment method was declined, so automatic recharge stopped charging it. | Choose **Update card** in billing. A new default method gets a fresh attempt. |
| The bank asks for confirmation (3-D Secure) | The payment is waiting for you. | Complete the confirmation, on the hosted invoice page if billing links one. |

A payment that is finished on the hosted invoice page credits your balance the
same way a direct payment does. If a payment went through at your bank but the
balance has not changed, write to
[hello@kugelaudio.com](mailto:hello@kugelaudio.com) with the invoice number.

Adding a payment method and one top-up of at least €10 also raises your
[rate limits](/guides/rate-limits#reach-the-next-tier).

## Get help

[Status page](https://www.kugelaudio.com/status) ·
[hello@kugelaudio.com](mailto:hello@kugelaudio.com)
