> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> View prepaid credit balances and transfer committed contract credits between ClickHouse organizations.
# Self Service Prepaid Credit Management
export const Image = ({img, alt, size = "lg", background}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
return ;
};
If you purchase prepaid credits through a committed contract, you can manage how those credits are allocated across your ClickHouse organizations.
Use the **Prepaid credits** page to view balances and transfer credits between organizations.
Access prepaid credits
In the ClickHouse Cloud console, open **Settings**, then select **Prepaid credits** under **Account**.
To view prepaid credit balances, you need at least one of the following roles in an organization with committed contract credits allocated:
* [Admin](/docs/products/cloud/reference/security/console-roles#organization-roles)
* [Billing](/docs/products/cloud/reference/security/console-roles#organization-roles)
* A [custom role](/docs/products/cloud/guides/security/cloud-access-management/manage-custom-roles#create-custom-role) that grants permission to [view or manage billing details](/docs/products/cloud/reference/security/console-roles#console-permissions)
The page shows every organization where you have one of these roles or permissions, including organizations without prepaid credits.
If none of your organizations have prepaid credits, the tab shows an empty state with links to the pricing calculator and a form to contact Sales.
View credit balances
The summary shows prepaid credit totals across the organizations where you have the access described above.
| Metric | Description |
| ------------------------- | ------------------------------------------------------------------------------------------- |
| **Total Credits Granted** | All prepaid credits allocated to these organizations, including active and expired credits. |
| **Expired Credits** | All expired prepaid credits across these organizations. |
| **Credits Used** | All prepaid credits consumed by these organizations. |
| **Credits Available** | All active prepaid credits that these organizations have not yet consumed. |
If you don't have access to every organization allocated credits from a prepaid contract, the totals may be lower than the contract's full credit pool.
All amounts are in ClickHouse Credits (CHC), where 1 CHC equals \$1 of usage. If you purchased credits at a discount, you may receive more CHC than dollars paid.
Organization balances
Each row in the table below the summary represents one organization, with data reflecting all of that organization's prepaid balances.
* **Organization** shows the organization's name, a partially masked organization ID, and a link to its billing page for a breakdown of credit balances.
* **Credits granted**, **Expired credits**, **Credits used**, and **Credits available** use the same definitions as the summary, but apply to that organization's prepaid credits.
* **Credit status** shows the state of the organization's prepaid balances, as described below.
* **Expiration Date** shows the prepaid balance's expiration date. If there are multiple balances, it shows the latest expiration date.
| Status | Description |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Active** | The organization has one or more prepaid credit balances that have not expired. |
| **Expires soon** | The organization has only one active prepaid balance, and it expires within 60 days. This status remains until the balance expires. |
| **Expired** | All prepaid balances on the organization have end dates in the past. |
| **Spent** | All prepaid balances on the organization have been consumed but have not expired. This status takes precedence over **Active**. |
| **No Prepaid Credits** | The organization has no prepaid credits. |
Transfer credits
A credit transfer, also called a split, moves prepaid credits from a source organization to a target organization.
To transfer credits, you need the [Manage billing details](/docs/products/cloud/reference/security/console-roles#console-permissions) permission. The View billing details permission lets you view balances but does not allow transfers.
1. Click **Transfer** in the source organization's row.
2. Select an active credit grant. The panel lists the source organization's active grants and their expiration dates.
3. Select a target organization from the organizations you have access to.
4. Enter the amount to transfer.
5. Review the resulting balances and click **Transfer credits**.
Transfer rules
* You can transfer only **active prepaid credits**. You can't transfer trial credits.
* A credit transfer modifies the prepaid credits available to the source and destination organizations. It doesn't change the total active credits granted under your committed contract.
* Transferring prepaid credits into an organization in a trial or a grace period for non-payment makes it a prepaid organization. It starts consuming those credits.
* You can transfer all remaining prepaid credits out of a source organization only if it has a [backup payment method](/docs/products/cloud/reference/billing/managing-payment-methods#add-backup-cc-to-marketplace-org) or no services. Otherwise, the maximum transfer is 75% of the source organization's credit balance.
* You can't transfer credits between ClickHouse Cloud and [Bring Your Own Cloud (BYOC)](/docs/products/cloud/guides/infrastructure/deployment-options/byoc/overview) organizations.
* You can't transfer credits between organizations billed through different cloud marketplaces, such as AWS Marketplace and Google Cloud Marketplace.
Marketplace billing after a transfer
If the source organization is billed through an active AWS, Google Cloud, or Azure Marketplace contract, the target organization's billing setup determines what happens:
| Target organization's billing setup | Result |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **No marketplace subscription** | The target organization is automatically linked to the source organization's subscription. After all credits are consumed or expire, overages are billed to that marketplace account. |
| **A subscription on the same marketplace** | The transfer completes, and the target organization keeps its existing subscription for overages. The source organization's subscription is not copied. |
| **A subscription on a different marketplace** | The transfer is blocked. |
To bill overages for both organizations through the same marketplace subscription, see [how to use another organization's marketplace subscription](/docs/products/cloud/reference/billing/managing-payment-methods#steps-switch-org-different-org).
Review transfer history and notifications
After a transfer completes:
* A new entry appears in the **Transfer History** table below the organization table.
* Both the source and target organizations receive notifications in the UI, by email, and in Slack. Only users with [billing notification access](/docs/products/cloud/features/monitoring/notifications#customizing-notifications) receive these notifications.
If any part of a transfer fails, the entire transaction is blocked and an error is shown. No partial changes are applied.