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.
On this page
KugelAudio bills usage from a prepaid credit balance per organization. Rates per model are on the pricing page; this page explains how the balance behaves.
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.
Add credits
Open the billing page of the 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.
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
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 (close code 4003 on a
WebSocket) means one of two things: the credit balance is used up, or the
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 with the invoice number.
Adding a payment method and one top-up of at least €10 also raises your rate limits.