Docs

Configuring Fields and Labels 

As a merchant, you can configure fields and labels to collect required information from your customers.

Working with fields 

To access the Fields

Sign in to the Chargebee site, navigate to Settings > Configure Chargebee > Checkout and Self Serve Portal > Fields.

See also

Add product images to your product catalog items to display them on the checkout pages.

Enabling a field 

Turn on/off the toggle button to enable/disable a field.

Reordering a field 

You can click and drag fields to change the order of the fields on the checkout page.

Editing field name 

You can edit the name of a field and set different properties like mandatory, read-only, and show/hide for a field. The below screenshot list the properties you can set for a field. For example, set the email field as mandatory during checkout.

Note

Depending on the field, a subset of the properties will be available.

Configurable fields in Checkout 

You can configure the fields for the following sections.

Account Information 

Configure account fields to collect your customer information like name, email, company, and phone from the checkout page by enabling them here. You can also add/manage custom fields.

Information

You must set at least one field under Account information to Show or Mandatory when setting field properties. Otherwise, the account information page is skipped during checkout. However, the account information still appears as read-only on the final checkout page.

Custom fields for subscription 

Configure custom fields to collect subscription-related information from your customers.

Billing 

Configure billing fields to collect your customer's billing information such as an address, phone number, name, VAT number, and more.

Note

To configure tax details such as VAT or GST, you must set billing country as mandatory in your tax settings.Furthermore, you can select to display the addresses on the checkout page, self-serve portal, or both.

Shipping 

Configure shipping fields to collect your customer's shipping information, such as shipping address, name, phone number, and more.

  • Enable the Use the same configuration as billing setting to apply billing address configured properties to the shipping address.
  • Enable the In checkout show the option "Ship to my billing address" to allow your customers to choose billing address as the shipping address during checkout.
Note

The Ship to my billing address option does not appear in the In-App layout for Checkout when the Checkout is created via API for an existing customer who already has one or more billing address fields in Chargebee.

Payments 

Configure payment fields to collect your customer's payment-related information such as card number, expiry, and Cvv. Card Number and Expiry will be collected by default and stored in your payment gateway.

Overview

Checkout supports presenting legal agreements to customers during the purchase process.

You can add and manage multiple agreements, such as a terms of service, a privacy policy, or a refund policy, to meet various regulatory requirements. This helps you comply with legal standards around the world, such as those outlined by the Federal Trade Commission  (FTC), which require businesses to provide clear, truthful, and accessible information about agreements and offer cancellation methods that are as easy as the sign-up process.

Agreements support rich text formatting, including hyperlinks to additional resources or policies, as needed. Support for multiple languages based on the customer's locale is also included.

Chargebee logs timestamped data of customer agreement during checkout, which serves as proof in cases of disputes or chargebacks. An audit log of changes made to the legal agreements is also available to help improve transparency and compliance.

Add a legal agreement

To add a legal agreement to Checkout:

  1. Select Add legal agreement.

  2. Under Legal Agreement Name, enter a name to identify the agreement within Chargebee. This name, once saved, cannot be edited later.

  3. Click the tab for the language in which you want to add the legal agreement.

  4. Under Legal Agreement, enter the agreement text. Use rich text formatting as needed.

  5. Select Display a checkbox at checkout to obtain consent if you want the customer to explicitly agree before completing checkout.

  6. Repeat the steps for each configured language.

  7. Select Save.

  8. Repeat the steps to add more agreements.

Edit a legal agreement

You can edit a legal agreement, view its audit log, and restore previous versions. To do so:

  1. Click the more options menu for the agreement you want to edit.

  2. Select View.

  3. Edit the agreement text as needed.

  4. Select Update.

  5. Alternatively, under Audit Logs, find previous versions of the agreement listed in reverse chronological order.

  6. Select Restore Version next to the version you want to restore.

  7. Click Confirm in the dialog that appears.

Archive or restore a legal agreement

Archived legal agreements aren't displayed on Checkout pages. Restored agreements become visible again. To archive or restore a legal agreement:

  1. Click the more options menu for the agreement you want to archive or restore.

  2. Select Archive or Restore.

  3. Click Confirm in the dialog that appears.

View consent history

Each time a customer agrees to a legal agreement and completes a Checkout session, a log of the event is created in Chargebee Billing. To view this:

  1. Log in to Chargebee Billing .

  2. Select Customers in the left navigation.

  3. Click the customer name to open the details page.

  4. Scroll to Legal Information. Legal agreements are listed in descending order by date of consent.

  5. Click View details to view event information for the Checkout session.

Configure this field to collect consent from your customers during checkout. You can add consent, agreement labels and set up consent checkboxes for the checkout and Self-Serve portal.

Working with Labels 

You can customize the field labels and messages displayed in the Checkout Pages and Self-Serve Portal.

To access the labels

  • Sign in to the Chargebee site, navigate to Settings > Configure Chargebee > Checkout and Self Serve Portal > Labels.
Note

The available checkout labels to configure are based on the layout selected on the Layout tab.

Add a label 

To add a label, perform these steps.

  1. Click +Add more copy/text.

  2. Search the required labels in the search box.

  3. Click Add.

  4. Click Apply.

  5. Click Publish.

The label changes are now visible to your customers.

Here is an example of how the Checkout labels work.

The following illustration describes adding a note to the payment method screen during checkout. This note will be displayed for all the users on the Payment method screen during checkout.

During checkout, the note will appear as shown below:

Configuring thank you messages 

You can set up messages that will appear to your customers after they checkout. Full page checkout Thank you page supports both, Thank you title and Thank you message labels.

To add a Thank you message or title, perform these steps:

  1. Go to Messages.
  2. Click Edit and add the message.
  3. Click Apply.
  4. Click Publish.

Was this article helpful?
Loading…