From f13cc5ef1c93d7484e73def07507a91a6c458260 Mon Sep 17 00:00:00 2001
From: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Date: Thu, 31 Jul 2025 13:10:00 +0200
Subject: [PATCH 1/9] update billing compliance doc
---
.../manage/troubleshooting-billing-issues.md | 181 ++++++++++--------
1 file changed, 100 insertions(+), 81 deletions(-)
diff --git a/docs/cloud/manage/troubleshooting-billing-issues.md b/docs/cloud/manage/troubleshooting-billing-issues.md
index 5454ec20190..61e1327c3bd 100644
--- a/docs/cloud/manage/troubleshooting-billing-issues.md
+++ b/docs/cloud/manage/troubleshooting-billing-issues.md
@@ -15,118 +15,137 @@ import Image from '@theme/IdealImage';
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
+options to continue using ClickHouse Cloud:
-
+| Billing option | Description |
+|-----------------------------------------------------|-----------------------------------------------------------------------------------------|
+| [Direct PAYG](#direct-payg) | Add a valid credit card to your organization to Pay-As-You-Go |
+| [Marketplace PAYG](#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
+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
+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
+* 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
+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 {#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
+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
+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
+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
+ and credit.
2. Contacting sales to buy credits through a subscription on one of our supported
- cloud marketplaces (AWS, GCP, or Azure)
-
-
-
-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 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.
+
+
+
+## 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)
From f66d966dfabf613022db16cbb81a0de29072c1b3 Mon Sep 17 00:00:00 2001
From: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Date: Thu, 31 Jul 2025 13:21:08 +0200
Subject: [PATCH 2/9] remove duplicate anchor
---
docs/cloud/manage/troubleshooting-billing-issues.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/cloud/manage/troubleshooting-billing-issues.md b/docs/cloud/manage/troubleshooting-billing-issues.md
index 61e1327c3bd..afb39a1940d 100644
--- a/docs/cloud/manage/troubleshooting-billing-issues.md
+++ b/docs/cloud/manage/troubleshooting-billing-issues.md
@@ -21,7 +21,7 @@ options to continue using ClickHouse Cloud:
| Billing option | Description |
|-----------------------------------------------------|-----------------------------------------------------------------------------------------|
| [Direct PAYG](#direct-payg) | Add a valid credit card to your organization to Pay-As-You-Go |
-| [Marketplace PAYG](#marketplace-payg) | Set up a Pay-As-You-Go subscription via a supported cloud marketplace provider |
+| [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 your trial ends and no billing option has been configured for your organization,
@@ -61,7 +61,7 @@ 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.
-### Cloud marketplace pay-as-you-go billing {#marketplace-payg}
+### Cloud marketplace pay-as-you-go billing {#cloud-marketplace-payg}
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
From e31b0ef2b83263b6a08e758120b41dd6060b9324 Mon Sep 17 00:00:00 2001
From: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Date: Thu, 31 Jul 2025 15:24:45 +0200
Subject: [PATCH 3/9] Update troubleshooting-billing-issues.md
---
docs/cloud/manage/troubleshooting-billing-issues.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/cloud/manage/troubleshooting-billing-issues.md b/docs/cloud/manage/troubleshooting-billing-issues.md
index afb39a1940d..82e6d128449 100644
--- a/docs/cloud/manage/troubleshooting-billing-issues.md
+++ b/docs/cloud/manage/troubleshooting-billing-issues.md
@@ -44,7 +44,7 @@ the organization.
The credit card on file normally will be charged at the end of your monthly
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).
+due reaches $10,000 USD (more info on payment thresholds [here](/cloud/billing/payment-thresholds)).
The credit card on file must be valid, not expired, and have enough available
credit to cover your invoice total.If, for any reason, we are unable to charge
From 62698ab6363b989b65c3e16265776486ea585ed9 Mon Sep 17 00:00:00 2001
From: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Date: Fri, 1 Aug 2025 11:41:17 +0200
Subject: [PATCH 4/9] Update troubleshooting-billing-issues.md
---
docs/cloud/manage/troubleshooting-billing-issues.md | 9 ++++-----
1 file changed, 4 insertions(+), 5 deletions(-)
diff --git a/docs/cloud/manage/troubleshooting-billing-issues.md b/docs/cloud/manage/troubleshooting-billing-issues.md
index 82e6d128449..ea7d764df0a 100644
--- a/docs/cloud/manage/troubleshooting-billing-issues.md
+++ b/docs/cloud/manage/troubleshooting-billing-issues.md
@@ -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']
@@ -47,7 +47,7 @@ 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)).
The credit card on file must be valid, not expired, and have enough available
-credit to cover your invoice total.If, for any reason, we are unable to charge
+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:
@@ -86,7 +86,7 @@ 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
+restrictions outlined above for [Direct PAYG](#direct-payg) will apply - this
includes service suspension and eventual data deletion.
### Committed contract billing {#commited-spend-contract}
@@ -94,8 +94,7 @@ includes service suspension and eventual data deletion.
You may 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. Payment terms will be set forth in the applicable order form
- and credit.
+ 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). Fees will be reported to the applicable
marketplace upon acceptance of the private offer and thereafter in accordance
From d3a4a28a76d4e241cdafc9592cf6f554e81461ab Mon Sep 17 00:00:00 2001
From: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Date: Fri, 1 Aug 2025 11:42:45 +0200
Subject: [PATCH 5/9] Update vercel.json
---
vercel.json | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/vercel.json b/vercel.json
index d7e6a7a835d..3e897ae8c33 100644
--- a/vercel.json
+++ b/vercel.json
@@ -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
}
]
}
From 16573d2a551f38607180ab47637be2a87bcdca69 Mon Sep 17 00:00:00 2001
From: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Date: Fri, 1 Aug 2025 16:36:12 +0200
Subject: [PATCH 6/9] Update troubleshooting-billing-issues.md
---
docs/cloud/manage/troubleshooting-billing-issues.md | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/docs/cloud/manage/troubleshooting-billing-issues.md b/docs/cloud/manage/troubleshooting-billing-issues.md
index ea7d764df0a..dc2fddbd888 100644
--- a/docs/cloud/manage/troubleshooting-billing-issues.md
+++ b/docs/cloud/manage/troubleshooting-billing-issues.md
@@ -102,8 +102,9 @@ You may purchase credits for your organization through a committed contract by:
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 accepted private offer.
+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.
From 05994c9099322c42b11abac50c201cdb1cb51e46 Mon Sep 17 00:00:00 2001
From: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Date: Fri, 1 Aug 2025 18:20:36 +0200
Subject: [PATCH 7/9] Update index.md
---
docs/cloud/manage/billing/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/cloud/manage/billing/index.md b/docs/cloud/manage/billing/index.md
index 8f51124a3a7..f940c75a034 100644
--- a/docs/cloud/manage/billing/index.md
+++ b/docs/cloud/manage/billing/index.md
@@ -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. |
From a09d8ebaaeb6bc22abea76f221721563717ca455 Mon Sep 17 00:00:00 2001
From: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Date: Sat, 2 Aug 2025 12:40:17 +0200
Subject: [PATCH 8/9] Update troubleshooting-billing-issues.md
---
docs/cloud/manage/troubleshooting-billing-issues.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/cloud/manage/troubleshooting-billing-issues.md b/docs/cloud/manage/troubleshooting-billing-issues.md
index dc2fddbd888..540f72786c9 100644
--- a/docs/cloud/manage/troubleshooting-billing-issues.md
+++ b/docs/cloud/manage/troubleshooting-billing-issues.md
@@ -1,6 +1,6 @@
---
sidebar_label: 'ClickHouse Cloud billing compliance'
-slug: /manage/clickHouse-cloud-billing-compliance
+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']
From 342615e4927487c7c1de25c1c0f598ac8b13db1b Mon Sep 17 00:00:00 2001
From: Shaun Struwig <41984034+Blargian@users.noreply.github.com>
Date: Sat, 2 Aug 2025 12:40:37 +0200
Subject: [PATCH 9/9] Update vercel.json
---
vercel.json | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/vercel.json b/vercel.json
index 3e897ae8c33..90949ea1974 100644
--- a/vercel.json
+++ b/vercel.json
@@ -3373,7 +3373,7 @@
},
{
"source": "/docs/manage/troubleshooting-billing-issues",
- "destination": "/docs/manage/clickHouse-cloud-billing-compliance",
+ "destination": "/docs/manage/clickhouse-cloud-billing-compliance",
"permanent": true
}
]