Invoices and Payments

Review completed tenant invoices and the payments attached to them.

Payments are handled through Paddle, while Kupe keeps the invoice record and status visible in the console.

When you’re charged

Everything in Kupe is billed monthly in arrears: you’re charged for what you used, after you’ve used it. Once your billing period closes, one invoice covers that period:

• Plan fee — your plan (Starter, Pro, Business), prorated by the day across any mid-period plan changes, so each plan is charged for exactly the days it was active.
• Resource usage — CPU, memory, and storage metered across the period.
• Observability overage — metrics active series and log ingest (measured as uncompressed bytes received) beyond your plan’s included allowance.
• High Availability — control-plane hours for clusters with HA enabled.
• Credits — any promotional credits on your account are deducted before payment is taken.

Your saved card is charged automatically shortly after the period closes — there’s a short settle delay while the period’s final usage lands. Nothing is billed ahead of time, and there’s nothing to pay manually.

At signup

You add a payment method — a £0 checkout that saves your card. Nothing is charged at signup. Your first invoice arrives after your first billing period closes, and it covers only that period — the plan fee for the days you were on it, plus what you actually used.

Every month after

You get one invoice for the period that just ended — plan fee and usage together, both in arrears.

Example — your billing period runs 1 July → 31 July. Shortly after the period closes, in early August, one invoice is issued and your card is charged:

• Pro plan — 1 Jul → 31 Jul: £49.00 (July’s plan fee)
• Usage — 1 Jul → 31 Jul: £6.20 (what you actually used in July)
• Total: £55.20 (excluding VAT — Paddle adds any applicable tax at payment)

If you had switched from Starter to Pro partway through July, the same invoice would instead carry a line for each plan, each charged for the days it was active.

The Billing page shows your usage accruing in real time, so your invoice is never a surprise.

Invoice lifecycle

Invoices move through these statuses:

• Draft: the billing period is still open or the invoice is not finalized yet
• Billed: the invoice has been issued and the payment submitted
• Paid: payment completed successfully
• PastDue: a payment attempt failed — Paddle retries automatically, and the invoice stays past due until a retry succeeds

What an invoice includes

Each invoice can include:

• billing period start and end
• one line item per cost component, broken down per cluster
• subtotal before credits
• credits applied
• final total
• current status

Amounts shown in Kupe exclude VAT. Paddle, as Merchant of Record, applies any applicable tax when your card is charged and issues the tax invoice/receipt.

Invoice names

Invoice names are assigned by the platform. They are usually {tenant}-{YYYYMMDD}, where the date is the start of the billing period — for example, acme-20260701 for the period starting 1 July 2026 — and a -final suffix marks the closing invoice when a tenant is deleted, so anything used since the previous invoice is still billed exactly once. Other variants exist, so don’t construct names yourself: list your invoices (in the console, CLI, or API) and use the names exactly as they appear.

Line items

Line items are grouped around the things Kupe bills for:

• plan fee (prorated by the day across plan changes)
• CPU
• memory
• storage
• metrics active-series overage
• log ingest overage
• High Availability control plane

That makes it easier to compare the current-period estimate with the final invoice once the period closes.

Payment processing

Paddle is the Merchant of Record and the source of truth for payment state. When an invoice is issued, your saved card is charged automatically — there’s no checkout to complete and no manual payment step. Kupe syncs the payment status back into the invoice record so the console reflects whether an invoice is billed, paid, or past due.

If a payment fails, Paddle retries it automatically and the invoice shows as PastDue until payment succeeds. If your card has expired or been replaced, save a new one from the Billing page.

Plan changes are billed through this same monthly flow — they take effect immediately, but the prorated fees land on your next invoice rather than triggering a separate charge.

If you do not see invoices yet

It is normal for the invoice table to stay empty until your first billing cycle completes. Before that, use the current-period estimate on the Billing page.

Next steps

• Usage and Costs: understand how the estimate is built
• Credits: see how credits reduce the invoice total