Getting Started

Building Blocks

Subscription Features

Localization

Invoices

Credits

Billing Features

Taxes

Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages

Notifications

Reports and Analytics

Attach Additional Data

Migration

Open Source Resources

Other Features

API Integration

Third Party Integrations

Configuring Hosted Pages 

Introduction 

Here's where you can customize the elements of your Hosted Pages and Customer Portal. show/hide fields, customize their behavior, edit the Info and Alerts, Field Configuration, Text Configuration etc.

Note

Users who signed up before March 1st 2014 click here. If you want the new hosted pages, email us at support@chargebee.com .

Field Configuration 

To configure your fields, go to Settings › Hosted Pages Settings › Field Configuration. You can decide the fields that you want to show/hide on the Hosted Checkout Pages and Customer Portal, whether the fields should be mandatory or optional can also be specified here. You can either choose from pre-configured profiles or manually configure the fields needed in the hosted pages.

Account Information

You can customize the behavior of all the fields under the Account Information section. This can be specified for both the Hosted Checkout Pages and Customer Portal.

The options for the Hosted Checkout Pages are:

Requested - The field is shown on the hosted page.

Not Requested - The field is not shown on the hosted page.

Hidden Parameter - Field will not be shown but you can pass values as parameters.

Copied from billing - The field will not be shown but the field content will be copied from the corresponding field in the billing address section. If a particular field is configured to be copied from billing, the corresponding field in the billing address section should be enabled.

Copied from shipping - The field content will be copied from the corresponding field in the shipping address section. If a particular field is configured to be copied from shipping, the corresponding field in the shipping address section should be enabled.

The options for the Customer Portal are:

Hidden - Field will not be shown on the customer portal.

Read Only - Field will be visible but content cannot be edited.

Editable - Field content can be updated.

Note

If you are using EU VAT for your taxes, you need to enable the VAT Number field in the field configurations. If you do not enable this field, then it will not be shown on the hosted pages.

Add Custom Fields to Hosted Pages

You can also add Custom Fields on your Hosted checkout pages, Update Card page and Customer portal. Customize the field behavior of the available Custom Fields as shown below:

The possible options for the Hosted Checkout Pages are:

Requested - The field is shown on the hosted page.

Not Requested- The field is not shown on the hosted page.

Hidden Parameter - Fields will be hidden on the hosted page, but you can pass value for this field during sign up. Read more.

The possible options for the Customer Portal are the same as the fields in the account information section above.

You can also specify the sequence in which the Custom Fields will appear on your hosted pages, using the reorder buttons:

Zip code Validation

By default, zip code validation is not enabled because there are some countries that do not have a zip code. You can specify whether or not to validate the zip code entered by the subscriber. If validation is enabled and the zip code is entered by the subscriber, it will be validated based on the country selected. Enabling zip code validation is also a way for making the zip code field mandatory on the hosted page.

Info and Alerts 

These are the messages and alerts that are shown to your customers in the customer portal for different scenarios. You can configure the content that needs to be shown. We also support using merge fields here and you can add the fields you need to automatically populate those fields with data. To configure, go to Settings › Hosted Pages Settings › Info and Alerts.

Text Configuration 

Enter the label text for all the fields to be shown on the Hosted ages, Update Card Pages and Customer Portal. To configure, go to Settings › Hosted Pages Settings › Text Configuration.

This includes text for:

  1. Field labels
  2. Titles
  3. Prefix and suffix
  4. Buttons

For instance, if you need to change the text of the Subscribe button on the checkout page, navigate to Settings > Hosted pages settings > Text Configuration.

The changes will appear on the checkout page as shown below.

Note

The Custom Domain feature allows you to white label your own subdomain and use it in the Hosted page URLs. So by default, the URL will be example.chargebee.com and you can choose to set the URL as checkout.example.com.
If you'd like this feature enabled for your Chargebee site, email us at support@chargebee.com 

FAQ 

1.Where are Customer & Subscription specific custom fields shown in the Hosted Pages?

Custom Fields for Customers, if configured, will be available in the Account Information section:

Custom Fields for Subscriptions, if configured, will be shown in the Additional Information section:

2.How can I hide "Powered by Chargebee" that is visible in the Checkout page?

The Powered by Chargebee message on the invoice/customer portal etc.can be removed by unchecking the "Hide Chargebee branding" under Settings > Site Settings > Site Info.

You can hide ‘Powered by Chargebee' only if you have activated your LIVE site however, it cannot be hidden from Test Sites.

3.How to display the Plan description on the Hosted Page?

You can use Chargebee's Trial Information field under Info & Alerts. This option will allow you to display a plan description on checkout pages, at the bottom in the Order Summary section.

Here's how you could accomplish this:
Go to Settings > Hosted Pages Settings > Info & Alerts section.
Scroll down to the Checkout section, select the Show checkbox against Trial Information. Enter the plan description for different plans in the following format:

 {{#plan.id= plan-id1}}
   Plan 1 description
 {{/plan.id= plan-id1}}
 {{#plan.id= plan-id2}}
   Plan 2 description
 {{/plan.id= plan-id2}}
Note

Using the Plan ID is preferable so that you can display content specific to each plan.
Feel free to be creative with other MergeVar that suit your needs.

4.How can I hide the shipping/billing address fields on the checkout pages?

To remove the shipping address fields on the checkout page, navigate to Settings > Hosted pages settings > Field Configurations > Shipping/Billing Information and uncheck all the fields.

Note

These fields can be still be populated in the background via the checkout page URL/API.

Loading…