Skip to content

Help

Invoices, failed payments and updating your card

Tested with:Databasezy API v1 · zb CLI 0.1

Invoices and payments are handled by Stripe. You find invoices under Billing → Invoices in the portal and in the emails Stripe sends, and you change your card through Manage payment method on the Billing page, which opens the Stripe customer portal. If a payment fails, your databases keep running during a grace period while Stripe retries; update the card to settle it. We never see or store your card number.

  • Portal: Billing → Invoices lists finalised invoices with a link to the Stripe-hosted invoice page and the PDF. Seeing invoices needs the View billing permission (billing:read), which owners, admins and billing members have.
  • Email: every invoice is also emailed to you.
  • Stripe customer portal: open it from Billing → Manage payment method; it lists past invoices too.

Free organizations are never billed and have no invoices. On a paid plan, the first invoice is issued at the end of your first billing period. Each invoice charges the plan fee for the coming period and the usage of the period that just ended. Enterprise contracts are invoiced under their contract terms.

The API serves the same list:

shell
zb api GET /v1/orgs/{org}/invoices

How do I update my card or payment method?

Section titled “How do I update my card or payment method?”
  1. In the portal, open Billing.
  2. Choose Manage payment method. You are sent to the Stripe customer portal for your organization.
  3. Add the new card and make it the default, then return to Databasezy.

Only owners, admins and billing members can manage the payment method. If the button is missing, ask one of them, or check your role on Teams, roles and permissions.

“Your last payment did not go through”

Section titled ““Your last payment did not go through””

This banner on the Billing page means Stripe could not collect an invoice. What happens next:

  • Stripe retries the payment automatically.
  • We email you on the day it fails and again 3 days later.
  • Your databases keep working normally during the grace period (up to 7 days).
  • After the grace period, our billing team reviews the account. Your databases keep running during the review, and nothing is deleted automatically because a payment failed. Agent servers are stopped until the invoice is paid (their disks are kept). Any cleanup of an unpaid account needs an administrator’s decision and is announced by email at least 24 hours before it can start; paying before then cancels it.

To fix it, update the card under Billing → Manage payment method. The open invoice is then paid on the next retry, or you can pay it straight away with Pay now on the banner (members who can view billing see it), or from the hosted invoice page linked under Billing → Invoices.

402 billing_frozen: “billing has frozen new resources for this organization”

Section titled “402 billing_frozen: “billing has frozen new resources for this organization””

The API answers this when billing has frozen the organization, which happens when a charge dispute is open or our billing team froze the account. Running databases keep running, but new instances, changes of size, storage or placement, apps, sandboxes and waking sleeping databases are refused. A dispute is resolved through a billing ticket, not by retrying.

Stripe collects your billing address and tax ID at checkout, when you first subscribe, and calculates tax automatically. Taxes appear on the invoice, not in the portal’s estimate. To add or change a tax ID or address afterwards, or to claim a tax exemption, open a ticket with category billing.

Refunds are decided by our staff, so ask in a billing ticket (the AI assistant sends refund and dispute questions straight to a ticket). Service credits for missed availability are described in the service level agreement. Promotional, referral and programme credits on your account are applied to invoices automatically; zb api GET /v1/orgs/{org}/credits lists them.

Search the help center or ask the assistant in the portal Help panel. If that does not solve it, open a support ticket from the portal (Help → Open a ticket, category billing) and include the invoice number, the date of the failed payment and the error Stripe showed you, if any. Never paste card numbers, passwords, connection strings with passwords, API keys or patient data (PHI) into a ticket. See How to get help.