Skip to main content

Billing & Usage

The Billing page at kuploy.app/billing is your single pane of glass for managing your platform subscription, monitoring resource consumption, upgrading plans, and reviewing invoices.

Platform Billing vs. Your Users' Billing

This page covers your billing with kuploy.app — the platform subscription you pay. For setting up billing that your end users pay to you, see Cloud Billing Setup.

Accessing Billing​

  1. Sign in to kuploy.app
  2. Click Billing in the top navigation bar

Current Plan​

The plan banner at the top shows:

FieldDescription
Plan nameYour current tier (Hobby, Starter, Growth, Business, Enterprise)
PriceMonthly rate (or custom negotiated price for Enterprise)
Statusactive, trialing, past_due, or canceled
Trial endIf trialing, when the trial expires
Renewal dateWhen your subscription renews (if not trialing)

Trial Management​

If you're on a free trial:

  • A Trial badge appears next to your plan name
  • The trial end date is displayed
  • Click Pay Now to end the trial early and start billing immediately
  • At trial end, you'll be prompted to add a payment method or your instance will be frozen

Resource Usage​

The usage section shows aggregate consumption across all your licenses and instances as circular progress rings:

MetricWhat It Tracks
LicensesActive licenses vs. plan limit
ProjectsTotal projects across all instances
AppsTotal deployed apps
DatabasesTotal provisioned databases
DomainsTotal domains (custom + purchased)
SubdomainsFree *.kuploy.app subdomains
Build MinutesMonthly build minutes consumed
StorageTotal storage used (displayed in GB)

Usage Indicators​

Each ring is color-coded:

  • Green — below 80% of limit
  • Yellow — between 80–99% of limit
  • Red — at 100% (limit reached, resource creation blocked)
tip

If multiple rings are yellow or red, consider upgrading your plan to increase limits. Click Upgrade on a higher-tier plan card below the usage section.

Upgrading Your Plan​

The Available Plans section shows all tiers side by side:

  1. Review the limits and features of each plan
  2. Click Upgrade on the plan you want
  3. You'll be redirected to Stripe Checkout to complete payment
  4. Your limits are updated immediately after payment

For Enterprise plans, click Contact Sales to discuss custom pricing and limits.

For details on what each plan includes, see Licensing & Platform Plans.

Payment Method​

Click Manage Payment Methods to open the Stripe Customer Portal where you can:

  • Add or update credit/debit cards
  • Set a default payment method
  • View upcoming charges

Billing History​

The invoices section lists your recent invoices with:

  • Invoice number and date
  • Amount charged
  • Download link for the PDF invoice

All invoice management (refunds, disputes) is handled through Stripe. Click Manage in Stripe in the plan banner to access the full Stripe portal.

Stripe Integration​

All payment processing is handled by Stripe. Kuploy never stores your card details — Stripe manages that securely. The following actions all route through Stripe:

ActionFlow
Upgrade planStripe Checkout session
Manage paymentStripe Customer Portal
Download invoiceStripe-hosted PDF
End trial earlyStripe subscription update (or Checkout if no payment method)

Billing Period​

Your billing period is shown in the usage data. Build minutes are automatically reset to zero across all your instances when a new billing cycle starts (triggered by a successful invoice payment from Stripe). Storage is not reset — it reflects current disk usage.

If your account enters past_due status:

  1. Stripe retries the charge automatically (up to 3 attempts)
  2. A warning banner appears in the dashboard
  3. After the retry window, the account may be suspended
  4. All instances continue to operate in read-only mode during the grace period

Contact support if you need to resolve a payment issue.