Docs
As a merchant, you can configure fields and labels to collect required information from your customers.
To access the Fields
Sign in to the Chargebee site, navigate to Settings > Configure Chargebee > Checkout and Self Serve Portal > Fields.
Add product images to your product catalog items to display them on the checkout pages.
Turn on/off the toggle button to enable/disable a field.
You can click and drag fields to change the order of the fields on the checkout page.
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.
Depending on the field, a subset of the properties will be available.
You can configure the fields for the following sections.
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.
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.
Configure custom fields to collect subscription-related information from your customers.
Configure billing fields to collect your customer's billing information such as an address, phone number, name, VAT number, and more.
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.
Configure shipping fields to collect your customer's shipping information, such as shipping address, name, phone number, and more.
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.
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.
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.
To add a legal agreement to Checkout:
Select Add legal agreement.
Under Legal Agreement Name, enter a name to identify the agreement within Chargebee. This name, once saved, cannot be edited later.
Click the tab for the language in which you want to add the legal agreement.
Under Legal Agreement, enter the agreement text. Use rich text formatting as needed.
Select Display a checkbox at checkout to obtain consent if you want the customer to explicitly agree before completing checkout.
Repeat the steps for each configured language.
Select Save.
Repeat the steps to add more agreements.
You can edit a legal agreement, view its audit log, and restore previous versions. To do so:
Click the more options menu for the agreement you want to edit.
Select View.
Edit the agreement text as needed.
Select Update.
Alternatively, under Audit Logs, find previous versions of the agreement listed in reverse chronological order.
Select Restore Version next to the version you want to restore.
Click Confirm in the dialog that appears.
Archived legal agreements aren't displayed on Checkout pages. Restored agreements become visible again. To archive or restore a legal agreement:
Click the more options menu for the agreement you want to archive or restore.
Select Archive or Restore.
Click Confirm in the dialog that appears.
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:
Log in to Chargebee Billing .
Select Customers in the left navigation.
Click the customer name to open the details page.
Scroll to Legal Information. Legal agreements are listed in descending order by date of consent.
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.
You can customize the field labels and messages displayed in the Checkout Pages and Self-Serve Portal.
To access the labels
The available checkout labels to configure are based on the layout selected on the Layout tab.
To add a label, perform these steps.
Click +Add more copy/text.
Search the required labels in the search box.
Click Add.
Click Apply.
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:
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: