Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

Custom Domain

The standard configuration for Chargebee's hosted checkout and portal uses the chargebee.com domain. However, you can replace the default Chargebee domain with your own, allowing you to personalize your checkout and portal pages with your unique domain name. This customization ensures a seamless and unified experience for your customers, offering them payment pages with your domain that they can recognize and trust.

For example, your current checkout page URL might read yourcompanyname.chargebee.com. With the Custom Domain feature enabled, you can have a URL like billing.yourcompanyname.com, checkout.yourcompanyname.com, or any other variation with your company name.

Let's see how you can set up your custom domain name.

Setting up a custom domain

To set up your custom domain name, follow these steps:

  1. Obtain the CNAME specific to your desired domain name from Chargebee.
  2. Configure the acquired CNAME within your domain registrar.
  3. Confirm the successful update of the CNAME.

Let's explore each of these steps in detail.

Get the CNAME from Chargebee

Follow these steps:

  1. Identify the domain name you wish to use for the hosted capabilities (for example, billing.yourcompanyname.com).
  2. Write to the Chargebee Support team at support@chargebee.com with the desired domain name and your Chargebee site name mentioned in the request email.
  3. The support team will provide a CNAME entry that you'll need to configure at your domain registrar. Chargebee Support will assist you in configuring it.

Verify the CNAME update

Once the CNAME configuration is completed, note that it may take up to 72 hours for the CNAME record changes to take effect.

To verify if the DNS propagation is complete and the CNAME records have been updated for your domain, you can use a third-party DNS Propagation Checker tool.

Once the DNS propagation is confirmed, Chargebee will make changes to route the pages with the domain name you have provided.

Modify your custom domain

Write to support@chargebee.com mentioning your old and new domains along with the Chargebee site name in the email to modify your custom domain.

Information

If your current Chargebee site is active, meaning the checkout is live for your customers, it's crucial to plan a designated time slot for transitioning to the new domain for your live site. This ensures that all links to the checkout and portal are properly updated with the new subdomain.

Note:

Address Autocomplete is enabled by default only on the Chargebee domain. If you are migrating to a custom domain and want to use Address Autocomplete, contact Chargebee Support and provide the Google Maps API key for the Place Autocomplete JavaScript API in a secure document.

Articles & FAQs

How to request for the Custom Domain feature?

Was this article helpful?