Skip to content
Kupe Cloud Kupe Cloud Kupe Cloud Docs

Invoices and Payments

Invoices are the completed billing records for a tenant. They show the billing window, the final line items, any credits applied, and the resulting total.

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

Invoice lifecycle

Section titled “Invoice lifecycle”

Invoices move through these statuses:

  • Draft: usage is still being accumulated or the invoice is not finalized yet
  • Billed: the invoice has been issued and submitted for payment processing
  • Paid: payment completed successfully
  • PastDue: payment did not complete by the due date
  • Canceled: the invoice was voided

What an invoice includes

Section titled “What an invoice includes”

Each invoice can include:

  • billing period start and end
  • compute and observability line items
  • subtotal before credits and tax
  • credits applied
  • tax
  • final total
  • due date and current status

Line items

Section titled “Line items”

Line items are grouped around the things Kupe bills for:

  • CPU
  • memory
  • storage
  • metrics overage
  • log overage
  • plan fee where applicable

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

Payment processing

Section titled “Payment processing”

Paddle is the payment processor and source of truth for payment state. Kupe syncs that status back into the invoice record so the console reflects whether an invoice is billed, paid, or past due.

Plan changes and payment processing are therefore handled as part of the Paddle-backed billing flow, not as a separate manual process in the console.

If you do not see invoices yet

Section titled “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

Section titled “Next steps”