New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now

Docschargebeedocs

HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
    • Setting Up and Managing Sandbox Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model Context Protocol)

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Getting Started
  3. Understanding Sites
  1. Billing
  2. Getting Started
  3. Understanding Sites

Understanding Sites

Once you sign up for Chargebee, you will be guided to set up a ‘Site' by adding your domain and company name.

A Site is the heart of a Chargebee account. This is where you'd maintain all your information in Chargebee. Any account in Chargebee will have 2 sites - Test Site and Live Site.

image

In this documentation we are going to see how to set up and manage your sites.

Configuring Domain Name

Domain name is your site's name in Chargebee. Once you sign up with Chargebee, a ‘Complete Account Setup' email will be sent to your email ID. Click the link in the email to setup your password and domain name.

image

Each domain name in Chargebee is unique just like your business. It is mandatory that you finish your account setup process in order to perform customer facing actions in Chargebee.

image

Test Site

Once you set up your domain name, you will be able to login to your test site. The test site is a sandbox environment where you can get hands-on experience of Chargebee. You can explore the Test Site by testing your billing configurations, creating plans, adding customers, subscriptions, and more. The information that you add or delete here will have no effect on your actual customer data. You can use this environment to test new features released by Chargebee.

Auto-Populate Test Site from your Pricing Page during Sign Up

Chargebee enables an AI-powered test site setup by parsing your business website's pricing page. This automates the demo site creation by configuring product families, plans, addons, price points, features, and brand by learning from your website.

This eliminates the need for manual data entry, providing a fast, relevant, and customized onboarding experience.

This section explains how to automatically populate your test site based on your website's pricing page.

Prerequisites

  • You must sign up with a valid business email.
  • Your website must have a publicly accessible pricing page.

To auto-populate your test site based on your website's pricing page, follow these steps:

  1. Sign up for a Chargebee Billing test site using your business email.
  2. Claim your account from your registered business email. From the email address you provided during sign-up, Chargebee will try to find the pricing page and, if available, provide an option to auto-populate the Chargebee test site. If there's no pricing page, you can provide any pricing page URL.
  3. Click Proceed to continue with auto-configuration or Skip the setup. If you choose Skip, it will take you to your test site's dashboard without any auto-configuration.
    image
    1. When you click Proceed, product details from your website appear. Click Continue to pricing to see the pricing details.
      image
    2. Click Continue to brand to see the branding template changes based on your brand color and logo.
      image
    3. Click Proceed to sandbox to see the test site with your products, prices, and more.
      image
  4. Once the sync is completed, on your Chargebee test site, review the generated product families, plans, addons, price points, features, and brand detected from your pricing page. You can manually modify these at any time.

Note

  • After setting up your test site, you can repopulate it from your pricing page or any pricing page.
  • Some websites may block scraping attempts due to third-party protections (e.g., Cloudflare), preventing Chargebee from accessing the pricing page.
  • When no pricing page is detected, you will be prompted to enter a pricing page URL of your choice that fits your business model.
  • AI-generated setups may not always match the pricing page 100%. They aim to be as accurate as possible, but they may occasionally require manual refinement.

View History

To view the history of auto-populated data for your site, please navigate to Settings > Personalized Sandbox Data from the left navigation. Click View Past Populations. You will see the history of auto populations.

image

Managing Test Site Data

By default, your Test site will be populated with sample data that you can use to test various billing scenarios. You can also add your own customer information and explore the product's capabilities. To delete or repopulate the sample data provided by Chargebee, click Settings > Configure Chargebee > Delete or Repopulate Sample Data.

image

Repopulate Test Site Data from a Pricing Page

Your old site data will be cleared, and the new data generated from the given pricing page will be populated.

If you want to repopulate your test site data, such as product families, plans, addons, price points, features, and brand from your pricing page or any other pricing page, follow the steps

  1. Login to your Chargebee Billing test site.
  2. Navigate to Settings > Configure Chargebee > Personalized Sandbox Data.
  3. Click Repopulate Data.
  4. Follow steps 3 and 4 to repopulate your test site data.

View history of your repopulated test site data.

Chargebee Test Payment Gateway

Chargebee Test Gateway allows you to visualize scenarios such as payment success, payment failure (due to invalid card details or insufficient funds), smart routing etc. This test gateway is available only in the Test Site. When you sign up for Chargebee, Chargebee's Test Gateway will be configured by default for your account. However, you can also choose to configure multiple Chargebee Test Gateways if you wish to test features.

image

Time Machine

Time Machine is a simulation feature that allows you to test the billing configurations in Chargebee. You can test features such as dunning, consolidated invoicing, subscription states, scheduled subscription actions, webhooks, etc., by virtually traveling in time. This allows you to understand and verify how the billing rules configured in your test site will work in real time. Time Machine is available only on your Test site. You can access the Time Machine by clicking Settings > Configure Chargebee > Time Machine.

Learn more about Time Machine.

Live Site

A Live site is where actual customer billing happens. Once you have tested all the features of Chargebee and want to start billing your customers in real time, you can go ahead and enable your Live site.

Before proceeding to enable your Live site, make sure to complete all the items in our Go Live Checklist.

Transfer Configurations

Chargebee understands that it is difficult to configure all the settings that you have set in your Test site again in your Live Site. Therefore to make work simple, Chargebee allows you to seamlessly transfer almost all of your Test site configurations into your Live site.

To use this tool, you must have the Live site enabled for your Chargebee Test site. Click Settings > Configure Chargebee > Transfer Configurations .

image

Learn more about Transfer Configurations.

Inviting Team Members

Chargebee allows you to share your site with your Team Members. You can also define various job functions that chalk out the kind of access each user will have to your site.

Click Settings > Team Members to share your site with someone. Learn more about sharing your site with your team members.

Note

You need to share your Test site and Live site individually with your Team Members for them to access it.

Changing Account Ownership

Chargebee supports transferring ownership of the site. This means that the current owner of the site will be able to transfer ownership to another user, a permanent change that will reflect in both the Test site and the Live site (even if the Live site has not been enabled yet). Learn more

Security

Chargebee allows you to set up Single Sign on and Two Factor authentication as a part of our security measures. Once you set them, they will be applicable for all your team members.

Chargebee Notifications

Chargebee allows you to configure alerts that can be sent internally to you and your team to notify important activities. You can configure Chargebee Notifications to get information on:

  • New Revenue Alerts: When the first invoice is created for a customer.
  • Invalid Payment Methods: Whenever the customer's payment method becomes invalid.
  • Fraud Monitoring: Whenever a suspicious transaction is detected. Please do note that this supported only in Stripe.
  • Daily Digest Mails: Mails regarding sign up, transaction summary etc.
  • Gateway Reconnect Mails: Mails regarding gateway access and configuration errors.
  • PayPal Chargebee Replication Alerts: When a subscription is changed in PayPal.
  • Webhook Failure Alerts: When a webhook fails.
  • Chargeback Automation Failure Alerts: When intervention is required to perform operations on invoices and subscriptions under chargeback.
  • Chargeback Won: When the gateway notifies that a chargeback is won.

Learn more about Chargebee Notifications.

Articles & FAQs

My site name is not getting displayed in the Chargebee dashboard
How to create a second test site with Chargebee?
How can I update my information (billing/account/payment) with Chargebee?
Error: "Your request was made in live mode but you are using a test card" – how to switch to test mode
Unable to accept invite due to unclaimed site
I created a second account with Chargebee accidentally – how do I delete it?
Why am I asked to set up an account when I am accepting an invite for my organisation?
Cannot change street address in the Business Profile
Login error: "Oops. Additional security token not passed! Please refresh the page and try again"
How many team members can be added to Chargebee site as per the plan?
How can I go LIVE with Chargebee?
How to exports customer records with additional contacts?
Can Google Recaptcha be disabled while logging into Chargebee?

Show more

Was this article helpful?