Skip to content

Update billing compliance doc #4194

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Aug 3, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/cloud/manage/billing/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,5 @@ This section of the documentation covers topics related to billing, and contains
|---------------------------------------|----------------------------------------------------------------------|
| [Overview](/cloud/marketplace/marketplace-billing) | Overview and FAQ pages for marketplace billing. |
| [Payment Thresholds](/cloud/billing/payment-thresholds) | Learn more about how payment thresholds work and how to adjust them. |
| [Troubleshooting Billing Issues](/manage/troubleshooting-billing-issues) | Troubleshoot common billing issues. |
| [Troubleshooting Billing Issues](/manage/clickhouse-cloud-billing-compliance) | Troubleshoot common billing issues. |
| [Marketplace](/cloud/manage/) | Landing page for further marketplace related topics. |
183 changes: 101 additions & 82 deletions docs/cloud/manage/troubleshooting-billing-issues.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
sidebar_label: 'ClickHouse Cloud billing compliance'
slug: /manage/troubleshooting-billing-issues
slug: /manage/clickhouse-cloud-billing-compliance
title: 'ClickHouse Cloud billing compliance'
description: 'Page describing ClickHouse Cloud billing compliance'
keywords: ['billing compliance', 'pay-as-you-go']
Expand All @@ -15,118 +15,137 @@

Your use of ClickHouse Cloud requires your organization to have an active and
valid billing method configured. After your 30 day trial ends or your trial
credits are depleted, you have the following billing options to continue using
ClickHouse Cloud:
1. Add a valid credit card to your organization to Pay-As-You-Go (PAYG)
2. Set up a Pay-As-You-Go subscription via a supported cloud marketplace provider (AWS, GCP, or Azure)
3. Reach out to [sales](https://clickhouse.com/company/contact) to negotiate a committed spend contract
directly or through a cloud marketplace committed contract.

If your trial has ended and no credit card or additional credits have been added,
all services will be stopped. If no action is taken within two weeks, all data
will be deleted.

If you choose to use the first Pay-As-You-Go option with a credit card, go to the
Billing section in the ClickHouse Cloud UI and click the 'Add Credit Card' button
(shown below) to complete the setup. If you have any questions please
[contact support](/about-us/support) for help.
credits are depleted, whichever occurs first, you have the following billing

Check warning on line 18 in docs/cloud/manage/troubleshooting-billing-issues.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.EOLWhitespace

Remove whitespace characters from the end of the line.
options to continue using ClickHouse Cloud:

<Image img={billing_compliance} alt="Billing Compliance" size="md"/>
| Billing option | Description |
|-----------------------------------------------------|-----------------------------------------------------------------------------------------|
| [Direct PAYG](#direct-payg) | Add a valid credit card to your organization to Pay-As-You-Go |
| [Marketplace PAYG](#cloud-marketplace-payg) | Set up a Pay-As-You-Go subscription via a supported cloud marketplace provider |
| [Commited spend contract](#commited-spend-contract) | Enter into a committed spend contract directly or through a supported cloud marketplace |

If you want to pay through one of our supported marketplaces (AWS, GCP, or Azure),
you can follow the steps [here](https://clickhouse.com/docs/cloud/marketplace/marketplace-billing)
for help. For any questions related specifically to cloud marketplace billing,
please contact the cloud service provider directly.

Helpful links for resolving issues with marketplace billing:
- [AWS Billing FAQs](https://aws.amazon.com/aws-cost-management/aws-billing/faqs/)
- [GCP Billing FAQs](https://cloud.google.com/compute/docs/billing-questions)
- [Azure Billing FAQs](https://learn.microsoft.com/en-us/azure/cost-management-billing/cost-management-billing-faq)
If your trial ends and no billing option has been configured for your organization,
all your services will be stopped. If a billing method still has not been
configured after two weeks, all your data will be deleted.

ClickHouse charges for services at the organization level. If we are ever unable
to process a payment using your current billing method, you must update it to one
of the three options listed above to avoid service disruption and remain compliant.
See below for more details about payment compliance based on your chosen billing
method.
of the three options listed above to avoid service disruption. See below for more
details about payment compliance based on your chosen billing method.

## Pay-as-you-go (PAYG) billing with a credit card {#payg-billing}
### Pay-as-you-go billing with a credit card {#direct-payg}

A credit card is considered compliant if it is valid, not expired, and has a
sufficient credit limit and available funds based on your invoice total.
You can pay for your ClickHouse Cloud usage monthly in arrears using a credit card.
To add a credit card, follow these [instructions](#add-credit-card).

If, for any reason, we are unable to charge the credit card associated with your
organization, the following unpaid invoice restrictions will immediately apply:
Your monthly billing cycle for ClickHouse begins on the day the organization tier
(Basic, Scale, or Enterprise) is selected, and the first service is created within
the organization.

- You will only be able to scale up to 120 GiB per replica
- You will not be able to start your services if stopped
- You will not be able to start or create new services
The credit card on file normally will be charged at the end of your monthly

Check warning on line 45 in docs/cloud/manage/troubleshooting-billing-issues.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.EOLWhitespace

Remove whitespace characters from the end of the line.

Check warning on line 45 in docs/cloud/manage/troubleshooting-billing-issues.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.FutureTense

Instead of future tense 'will be', use present tense.
billing cycle, but payment charges will be accelerated if the intracycle amount
due reaches $10,000 USD (more info on payment thresholds [here](/cloud/billing/payment-thresholds)).

We will attempt to process payment using the organization's configured billing
method for up to 30 days. If payment is not successful after 14 days, all services
within the organization will be stopped. In accordance with our [terms and conditions](https://clickhouse.com/legal/agreements/terms-of-service),
you have 30 days from the date the invoice becomes overdue to initiate a payment
dispute. If payment is still not received by the end of this 30 day period,
all data and services associated with your organization will be deleted.
The credit card on file must be valid, not expired, and have enough available

Check warning on line 49 in docs/cloud/manage/troubleshooting-billing-issues.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.EOLWhitespace

Remove whitespace characters from the end of the line.
credit to cover your invoice total. If, for any reason, we are unable to charge
the full amount due, the following unpaid invoice restrictions will immediately
apply:

## Cloud marketplace pay-as-you-go (PAYG) billing {#cloud-marketplace-payg}
* You will only be able to scale up to 120 GiB per replica

Check warning on line 54 in docs/cloud/manage/troubleshooting-billing-issues.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.FutureTense

Instead of future tense 'will only', use present tense.
* You will not be able to start your services if stopped
* You will not be able to start or create new services

Pay-As-You-Go billing can also be configured to charge an organization through
one of our supported cloud marketplaces (AWS, GCP, or Azure). However, if the
marketplace subscription is canceled or fails to renew automatically, billing will
fall back to the credit card configured for the organization. If a valid credit
card is not configured, the same unpaid invoice restrictions outlined above for
Pay-As-You-Go (PAYG) with a credit card billing will apply - this includes
service suspension and eventual data deletion.
We will attempt to process payment using the organization's configured billing

Check warning on line 58 in docs/cloud/manage/troubleshooting-billing-issues.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.EOLWhitespace

Remove whitespace characters from the end of the line.

Check warning on line 58 in docs/cloud/manage/troubleshooting-billing-issues.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.FutureTense

Instead of future tense 'will attempt', use present tense.
method for up to 30 days. If payment is not successful after 14 days, all services
within the organization will be stopped. If payment is still not received by the
end of this 30 day period and we have not granted an extension, all data and
services associated with your organization will be deleted.

## How does our PAYG marketplace billing schedule work? {#payg-marketplace-billing-schedule}
### Cloud marketplace pay-as-you-go billing {#cloud-marketplace-payg}

If you subscribe to ClickHouse through a cloud marketplace, your Pay-As-You-Go
sage will be invoiced according to the terms of your agreement with that
marketplace - typically on a calendar-month billing cycle.
Pay-As-You-Go billing can also be configured to charge an organization through one of our supported cloud marketplaces
(AWS, GCP, or Azure). To sign up for Marketplace PAYG billing, follow these
[instructions](#marketplace-payg).

## How does our direct billing schedule work? {#direct-billing-schedule}
Similar to billing via Direct PAYG, your monthly billing cycle with ClickHouse

Check warning on line 70 in docs/cloud/manage/troubleshooting-billing-issues.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.EOLWhitespace

Remove whitespace characters from the end of the line.
under Marketplace PAYG begins on the day the organization tier (Basic, Scale,
or Enterprise) is selected and the first service is created within the
organization.

For customers using Pay-As-You-Go with a credit card, the monthly billing cycle
begins on the day the first tier (Basic, Scale, or Enterprise) is selected and
the service is created within the organization.
However, because of the requirements of the marketplaces, we report the charges

Check warning on line 75 in docs/cloud/manage/troubleshooting-billing-issues.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.EOLWhitespace

Remove whitespace characters from the end of the line.
for your Pay-As-You-Go usage on an hour-by-hour basis. Note that you will be
invoiced according to the terms of your agreement with that marketplace - typically
on a calendar-month billing cycle.

## How are credits consumed that are applied to an organization? {#credits-consumed}
As an example, if you create your first organization service on January 18, your

Check warning on line 80 in docs/cloud/manage/troubleshooting-billing-issues.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.EOLWhitespace

Remove whitespace characters from the end of the line.
first billing usage cycle in ClickHouse Cloud will run from January 18 until the
end of the day on February 17. However, you may receive your first invoice from
the cloud marketplace at the beginning of the month of February.

Credits applied to an organization (e.g. through committed contracts or refunds)
are consumed starting on the day credit was granted in billing periods based on
the date the first tier (Basic, Scale, or Enterprise) is selected.
However, if your PAYG marketplace subscription is canceled or fails to renew
automatically, billing will fall back to the credit card on file for the
organization, if any. To add a credit card, please [contact support](/about-us/support)
for help. If a valid credit card has not been provided, the same unpaid invoice
restrictions outlined above for [Direct PAYG](#direct-payg) will apply - this
includes service suspension and eventual data deletion.

For all pay-as-you-go billing we will bill immediately if the amount due within
a billing period is equal to $10,000 USD (more info on payment thresholds [here](https://clickhouse.com/docs/cloud/billing/payment-thresholds)).
### Committed contract billing {#commited-spend-contract}

## Committed contract billing {#committed-contract-billing}
You may purchase credits for your organization through a committed contract by:

You have the option to purchase credits for your organization through a committed
contract by:
1. Contacting sales to buy credits directly, with payment options including ACH
or wire transfer.
or wire transfer. Payment terms will be set forth in the applicable order form.
2. Contacting sales to buy credits through a subscription on one of our supported
cloud marketplaces (AWS, GCP, or Azure)

<br/>

If an organization is **not** on a cloud marketplace committed contract and runs
cloud marketplaces (AWS, GCP, or Azure). Fees will be reported to the applicable
marketplace upon acceptance of the private offer and thereafter in accordance
with the offer terms, but you will be invoiced according to the terms of your
agreement with that marketplace. To pay through a marketplace, follow these
[instructions](#marketplace-payg).

Credits applied to an organization (e.g. through committed contracts or refunds) are
available for your use for the term specified in the order form or accepted private
offer.
Credits are consumed starting on the day credit was granted in billing periods
based on the date the first organization tier (Basic, Scale, or Enterprise) is
selected.

If an organization is **not** on a cloud marketplace committed contract and runs
out of credits or the credits expire, the organization will automatically switch
to Pay-As-You-Go (PAYG) billing. In this case, we will attempt to process payment
using the credit card configured for the organization.
to Pay-As-You-Go (PAYG) billing. In this case, we will attempt to process payment
using the credit card on file for the organization, if any.

If an organization **is** on a cloud marketplace committed contract and runs out
of credits, it will also automatically switch to PAYG billing via the same
marketplace for the remainder of the subscription. However, if the subscription
is not renewed and expires, we will then attempt to process payment using the
credit card on file for the organization.
credit card on file for the organization, if any.

In either scenario, if we are unable to charge the configured credit card, the
unpaid invoice restrictions outlined above for Pay-as-you-go (PAYG) billing with
a credit card will apply—this includes the suspension of services. However, for
committed contract customers, we will take all necessary steps to reconcile any
unpaid invoices before initiating data deletion. There will be no automatic data
deletion after 30 days.
unpaid invoice restrictions outlined above for [Pay-as-you-go (PAYG)](#direct-payg)
billing with a credit card will apply—this includes the suspension of services.
However, for committed contract customers, we will contact you regarding any
unpaid invoices before initiating data deletion. Data is not automatically
deleted after any period of time.

If you’d like to add additional credits before your existing ones expire or are
depleted, please [contact us](https://clickhouse.com/company/contact).

### How to pay using a credit card {#add-credit-card}

Go to the Billing section in the ClickHouse Cloud UI and click the 'Add Credit Card'
button (shown below) to complete the setup. If you have any questions, please
[contact support](/about-us/support) for help.

<Image img={billing_compliance} size="md" alt="How to add a credit card" />

## How to pay via marketplaces {#marketplace-payg}

If you want to pay through one of our supported marketplaces (AWS, GCP, or Azure),
you can follow the steps [here](/cloud/marketplace/marketplace-billing) for help.
For any questions related specifically to cloud marketplace billing, please
contact the cloud service provider directly.

Helpful links for resolving issues with marketplace billing:
* [AWS Billing FAQs](https://aws.amazon.com/aws-cost-management/aws-billing/faqs/)
* [GCP Billing FAQs](https://cloud.google.com/compute/docs/billing-questions)
* [Azure Billing FAQs](https://learn.microsoft.com/en-us/azure/cost-management-billing/cost-management-billing-faq)
5 changes: 5 additions & 0 deletions vercel.json
Original file line number Diff line number Diff line change
Expand Up @@ -3370,6 +3370,11 @@
"source": "/docs/guides/developer/lightweight-update",
"destination": "/docs/guides/developer/on-the-fly-mutations",
"permanent": true
},
{
"source": "/docs/manage/troubleshooting-billing-issues",
"destination": "/docs/manage/clickhouse-cloud-billing-compliance",
"permanent": true
}
]
}