Getting Started

Building Blocks

Subscription Features

Custom Fields

Localization

Invoices

Credits

Order Management

Billing Features

Taxes

Payment Methods

Direct Debit Payments

Configuring Gateways

Revenue Recovery

Checkout

Self-Serve Portal

Notifications

Reports and Analytics

Data Privacy & Security

Fraud Management

Migration

Other Features

Developers

Third Party Integrations

Getting Started 

Information

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

There are 2 use cases when a single page checkout will be used:

  1. Single Page Checkout (new customers)- This is the checkout page for new customers where they enter their account information and payment method details to sign up.
  2. Single page checkout(Payment Method Page) - Used for existing subscribers when they need to update their payment method details.

Single Page Checkout (New Customers) 

This page needs to be enabled (enabled by default) for users to be able to access it.

A Single Page Checkout page can be generated either by accessing the plan specific hosted page URL or by using the Hosted Pages  API.

Here is a sample Single Page Checkout page:

Configure Redirect URL - FOR API USERS 

This URL is where subscribers will be redirected to when their checkout is successful. This URL needs to be configured when using the hosted pages API integration. Click here to learn more.

Note

If you're integrating using the plan specific hosted pages, the redirect URL needs to be configured for each plan.

Configure Cancel URL 

If this URL is configured, a "Cancel" button will appear on the checkout page. Users can click on this to cancel their sign up.

Information

The redirect and Cancel URL can also be passed using the Checkout new / Checkout existing API . In such cases, the URL configured under Hosted Pages settings will be overridden.

You can include URLs for Privacy Policy and Terms of Service on your Single Page Checkout page.

Navigate to Settings > Configure Chargebee > Checkout & Self-Serve Portal > Checkout Page to provide the URLs and the text to be linked to the URLs.

You can also choose to include a consent option in the Single Page Checkout page, and specify the text for the same in the Agreement label text box.

Use the Quick Preview to see how your agreement label and URLs will appear on the checkout page.

Update Payment Method Page 

The update payment method page is where your existing customers can update their payment method details. A link for the hosted update payment method page can be generated when using the "Request Payment Method Details" option. This option is available in the subscription details page and sends an email to the subscriber along with the link to update their payment method details.

Update Payment method function is used in both Email Notifications V1 and Email Notifications V2.

In Email Notifications V1, the mail merge field customer.payment_method_update_url is used. It will auto-generate a link for payment and the link isincluded in the email that is sent to the customer. Clicking on the link will redirect the customers to the page where they update their payment method.

In Email Notifications V2, Update Payment Method will appear as a button. URL will be auto-generated and the customers will be redirected to the page to update the payment method when they click on the button.

You can also use the Update Payment Method  API to generate a link.

You can configure redirect URLs for the Update Payment Method Page by navigating to Settings > Configure Chargebee > Checkout & Self-Serve Portal > Payment method page:

Redirect URL 

This URL is where subscribers will be redirected to once they successfully update their payment method details.

Configure Cancel URL 

If this URL is configured, a "Cancel" button will appear on the update payment method page. Users can click on this to cancel the update operation.

Information

The Redirect and Cancel URL can also be passed via the Update Payment Method  API. In such cases, the URL configured in under Hosted Pages Settings will be overridden.

Customizing Single Page Checkout 

You can customize the look of your hosted pages based on your needs using themes. To get started, navigate to Settings > Configure Chargebee > Checkout & Self-Serve Portal > Hosted Pages Settings in your Chargebee Site.

Click here to know more.

Note

We recently released the Custom Domain feature, which lets you white label your own subdomain and use it in the hosted pages' URLs. If you'd like this feature enabled for your Chargebee site, write to support@chargebee.com 

FAQ 

Can I see how, say, an addon/plan with tiered pricing looks like on Chargebee Checkout and Self-serve Portal?

Yes, see this FAQ.

Was this article helpful?
Loading…