Skip to main content
Manage billing details, payment methods, and view usage and invoices for your CockroachDB Cloud organization.

​
Access Billing

Users with the Billing Coordinator or Billing Viewer role can access billing information.
1

Navigate to Billing

Click Billing in the Cloud Console navigation
2

View Billing Information

The Billing page shows:
  • Current billing period charges
  • Payment method
  • Billing contact information
  • Usage details
  • Invoice history

​
Set Up Billing

Configure payment methods and billing information.

​
Add Payment Method

Choose from multiple payment options:
1

Access Payment Details

Go to Billing > Payment details tab
2

Add Card

  1. Click Add a credit card
  2. Enter card details:
    • Card number
    • Expiration date
    • CVV
    • Cardholder name
  3. Click Save card
3

Add Billing Information

  1. Click Add a billing address
  2. Enter:
    • Company name (optional)
    • Street address
    • City, State/Province
    • ZIP/Postal code
    • Country
  3. Click Submit
4

Add Billing Email

  1. Click Add a billing email
  2. Enter email address for invoices
  3. Click Submit

​
Update Payment Method

1

Navigate to Payment Details

Go to Billing > Payment details
2

Edit Payment Method

  1. Click pencil icon next to Payment method
  2. Enter new credit card details
  3. Click Save card
3

Update Billing Address

  1. Click pencil icon next to Billing address
  2. Update address information
  3. Click Submit

​
Change Billing Email

1

Edit Email

  1. Go to Billing > Payment details
  2. Click pencil icon next to Email
  3. Enter new email address
  4. Click Submit

​
View Current Usage

Monitor your current billing period charges.

​
Overview Tab

The Overview tab shows: Current Billing Period:
  • Total charges to date
  • Estimated month-end total
  • Breakdown by cluster
  • Cost by resource type
Credits (if applicable):
  • Available credits
  • Credit usage rate
  • Credit expiration date
  • Contract details
1

View Usage Details

Click on any cluster to see detailed usage:
  • Compute costs
  • Storage costs
  • Data transfer
  • Backups
  • Changefeeds
2

Filter by Folder

If using folders, view costs grouped by folder hierarchy

​
View Invoices

Access historical billing information.

​
Invoices Tab

1

Access Invoices

Click Billing > Invoices tab
2

View Invoice List

See all past invoices with:
  • Billing period
  • Total amount
  • Payment status
  • Invoice date
3

View Invoice Details

Click any invoice to see:
  • Itemized charges by cluster
  • Resource usage breakdown
  • Credits applied
  • Taxes and fees

​
Export Invoices

Download invoices for accounting:
1

Select Invoice

Go to Invoices tab and find the invoice
2

Download

Click … menu and select:
  • Export CSV: Detailed line items
  • Export PDF: Traditional invoice format
CSV Export includes:
  • Cluster name and ID
  • Resource type
  • Usage quantity
  • Unit price
  • Total cost
  • Folder path (if using folders)
PDF Export includes:
  • Organization details
  • Billing address
  • Invoice summary
  • High-level usage breakdown
  • Payment information

​
Understand Your Bill

Break down invoice charges.

​
Line Item Categories

Basic:
  • Request Units consumed
Standard:
  • vCPU-hours provisioned
  • Billed hourly
Advanced:
  • Node-hours by machine type
  • Per-region breakdown
Basic/Standard:
  • GiB-hours used
  • Auto-scales with data
Advanced:
  • GiB-hours provisioned per node
  • IOPS charges (AWS only)
  • Same-region egress
  • Cross-region transfer
  • Public internet egress
  • Private endpoint traffic
  • Managed backup storage (per GiB-month)
  • Self-managed backup egress
  • Tiered pricing applied
  • Watched data size (per GiB-month)
  • Tiered pricing

​
Credits and Discounts

Credits applied to invoices: Trial Credits:
  • $400 for 30-day trials
  • Applied automatically
  • Shown as line item deduction
Free Monthly Credit (Basic):
  • $15/month for monthly billing
  • First usage is free up to limit
Enterprise Credits:
  • Annual contract credits
  • Applied in order purchased
  • Balance shown on Overview tab

​
Manage Marketplace Billing

​
AWS Marketplace

View Usage:
  • Charges appear on AWS bill
  • Detailed usage in CockroachDB Console
  • AWS Cost Explorer shows CockroachDB costs
Unsubscribe:
Unsubscribing deletes clusters within 6 hours unless you add an alternative payment method.
1

Go to AWS Marketplace

Navigate to Manage Subscriptions
2

Cancel Subscription

  1. Find CockroachDB (pay-as-you-go)
  2. Click Actions > Cancel Subscription
  3. Confirm cancellation
3

Add Alternative Payment

Add credit card in CockroachDB Console within 6 hours

​
GCP Marketplace

View Usage:
  • Charges on GCP bill
  • Detailed usage in CockroachDB Console
  • GCP Billing shows CockroachDB costs
Unsubscribe:
Clusters are deleted within 6 hours unless you add an alternative payment method.
1

Access GCP Marketplace Orders

Go to GCP Marketplace Orders
2

Cancel Order

  1. Select billing account
  2. Find CockroachDB (pay-as-you-go)
  3. Click Cancel Order
  4. Confirm cancellation

​
Cost Management

​
Set Spending Limits

Basic Clusters:
1

Configure Spend Limit

  1. Go to cluster Overview page
  2. Click Edit next to Spend limit
  3. Enter maximum monthly spend
  4. Click Save
2

Monitor Usage

Cluster is throttled when limit is reached

​
Budget Alerts

Set up notifications for spending thresholds:
1

Configure Alerts

  1. Go to Billing > Alerts
  2. Click Add Alert
  3. Set threshold amount
  4. Add email recipients
  5. Click Save

​
Cost Optimization

Review Regularly:
  • Check current usage weekly
  • Compare to previous months
  • Identify cost trends
  • Optimize underutilized clusters
Use Folders:
  • Organize clusters by project/team
  • View costs grouped by folder
  • Allocate costs appropriately
  • Track spending by department
Right-Size Clusters:
  • Review actual vs provisioned capacity
  • Scale down during off-peak
  • Delete unused dev/test clusters
  • Use appropriate plan for workload

​
Billing API

Access billing data programmatically.

​
Get Invoices

curl -X GET \
  https://cockroachlabs.cloud/api/v1/invoices \
  -H "Authorization: Bearer {api-key}"

​
Get Current Usage

curl -X GET \
  https://cockroachlabs.cloud/api/v1/usage/current \
  -H "Authorization: Bearer {api-key}"

​
Get Cluster Costs

curl -X GET \
  https://cockroachlabs.cloud/api/v1/clusters/{cluster-id}/costs \
  -H "Authorization: Bearer {api-key}"

​
Non-Payment Policy

What happens if payment fails: Payment Failure:
  1. Email notification sent
  2. Grace period begins (usually 7 days)
  3. Retry payment attempts
If Unresolved:
  1. Cluster access restricted
  2. Read-only mode enabled
  3. Further notification emails
Final Action:
  1. Clusters deleted after 30 days
  2. Data permanently removed
  3. No recovery possible
Keep payment information current to avoid service interruption.

​
Troubleshooting

​
Payment Declined

Causes:
  • Insufficient funds
  • Card expired
  • Security block by bank
  • Incorrect billing address
Solutions:
  1. Update payment method
  2. Contact your bank
  3. Try alternative payment method
  4. Update billing address

​
Cannot Access Billing

Issue: Billing page not accessible Solutions:
  1. Verify you have Billing Coordinator or Billing Viewer role
  2. Check you’re in correct organization
  3. Contact Organization Admin for access

​
Invoice Discrepancy

Issue: Unexpected charges Solutions:
  1. Review usage details in invoice
  2. Check for data transfer costs
  3. Verify backup storage charges
  4. Contact Support

​
Marketplace Billing Issues

Issue: Charges not appearing correctly Solutions:
  1. Allow 24-48 hours for marketplace sync
  2. Check marketplace console
  3. Verify subscription is active
  4. Contact Support for assistance

​
Next Steps

Pricing Details

Understand pricing components

Cost Optimization

Optimize resource usage

Plan Comparison

Compare plan features and costs

Support

Get help with billing

Build docs developers (and LLMs) love

Get started for freeTalk to us