Docs

Chargebee Self-Serve Portal 

Using the Chargebee Self-Serve Portal, customers can modify subscriptions (add, edit, pause, resume, cancel or reactivate), download previous invoices, manage payment methods, and manage addresses.

Enabling Self Serve Portal 

To enable Self-Serve Portal, click Settings > Configure Chargebee > Checkout and Self Serve Portal > Portal > Enable.

Configurations 

General Settings 

You can configure to display specific settings for your customers to access using the Self-Serve Portal. To set up the same, click Settings > Configure Chargebee > Checkout and Self Serve Portal > Portal.

Given below are the configurations for In-app Self-Serve portal:

  • Customers can access the self-serve portal: There are two ways for customers to access the self-serve portal.

    • Via Chargebee Login: This is the default portal built by Chargebee. Users can login to the portal by entering the email ID and a one-time password (OTP) sent via email. After the first login, they can also set up a password for subsequent logins.

    • Using single sign on API: This is the recommended approach if you are handling user-authentication at your end. Integrating portal via API allows you to use your app or website's user authentication to grant access to the self-serve portal. This improves your customer experience as they do not need to sign in again if they have signed into your app or website already. Learn more .

  • Allow customers to download invoices: Enable to allow customers to download previous invoices.
Information

The invoice might be hidden in the customer portal if any of the customers in the hierarchy are unlinked.

  • Allow customers to change subscription: Enable to allow customers to change their subscription using the self-serve portal. You can also control the behavior of change subscription action in Self-Serve Portal using the following sub-settings:

Setting

Functionality

Statuses in which subscriptions can be changed

Select the subscription states for which change subscription is allowed - active, non-renewing and trial.
Apply subscription changes Select when the changes made should be effective - immediately or at the end of term.
Allow customers to change plans Enable to allow your customers to change their plan. Proration applies as per site setting.
Allow customers to change plan quantity Enable to allow your customers to change plan quantity.
Allow customers to add addons Select to allow your customers to add addons to the existing plan. You can select to allow non-recurring addons, recurring addons or both. The Add Addons option is found under Edit Subscription in the portal. Recommended addons mapped to a plan are shown with a "recommended" tag.
Allow customers to remove addons Select to allow your customers to remove the addons added to their subscription. You can select to allow non-recurring or recurring addons or both.
Allow customers to change addon quantity Enable to allow your customers to change the quantity of each addon added to their subscription. You can select to allow non-recurring or recurring addons or both.
Allow customers to add/remove coupons Enable to allow your customers to add coupons or remove added coupons.

Sample of change subscription in Self-Serve Portal:

Sample of adding an addon in Self-Serve Portal:

Note

For addons and charges to appear in the Self-Serve Portal, you must enable the option Display in Self-Serve Portal while creating addons and charges.

If not enabled already, you can use the Edit action to enable it.

To enable it, click Product catalog > Addon (or) Charge and select the addon or charge which needs to be displayed in the portal. Under the Customer-Facing Info section, enable Display in Self-Serve Portal.

Allow customers to cancel subscription: Enable to allow customers to cancel their subscription using the Self-Serve Portal. On enabling, you can choose to control the behavior of cancel subscription using the following sub-settings:

  • When the subscription will get cancelled - Immediately/At the end of the term/Allow customers to choose

  • When you select Allow Customers to choose, you can also specify when customers can cancel their subscriptions - Immediately/At the end of term/On a specific date. By choosing "On a specific date", your customers can schedule the cancellation to happen on a particular date within the subscription period.

  • Allow customers to provide feedback during cancellation: Enable to collect feedback from customers while cancelling.

  • Allow customers to reactivate cancelled subscriptions: Enable to allow customers to reactivate their subscription. Learn more.

  • Allow customers to remove scheduled changes: Enable to allow customers to cancel any changes they have scheduled, such as a subscription pause.

  • Allow customers to remove scheduled cancellation: Enable to allow your customers to remove any subscription cancellations they have scheduled.

  • Allow customers to remove their primary payment method: Enable to allow customers to remove their primary payment method.

  • Allow customers to pause subscriptions: Enable to allow your customers to pause their subscriptions. Do note that for this to work, you must have enabled pause subscription for your site. Learn more.

    • Subscriptions will be paused: Select to allow your customers to pause the subscription at the end of the term or immediately.
    • How long will subscriptions be paused: Available options are:
      • Indefinitely: Pauses the subscription indefinitely until the customer themselves resume it or contact you to resume it.
      • Set a period: Pauses the subscription for a set number of days. You can set a maximum of 90 days.
      • Allow customers to choose the duration: Option to allow customers to set the number of days for pause.
Note

Allow customers to choose duration has two subsettings:

  • Pause Period: Option to set the maximum number of days a customer can choose for the pause period.
  • Pause Interval: Option to show specific pause days to the customer. There are a few default days, but you can also create a new interval – using the Manage option – with day limit within the maximum number set in Pause Period. You can also choose to show only specific intervals out of all the options by unchecking the ones you don't need.

Here's a screenshot of the manage pause interval window:

Advanced Settings 

Take a look at our detailed doc on Checkout and Portal Advanced Settings to know more.

3DS Support for Self-Serve Portal 

Chargebee's In-app Customer Portal supports 3DS transactions. Complete our SCA checklist, for handling seamless 3DS payments via Chargebee's Customer Portal.

Since no payment is involved during portal actions such as Update Payment Method  and Add Payment Method , we will trigger a minimum amount of 3DS authorization during those operations. The amount deducted for authorization would be voided automatically.

If there is any immediate charge involved during actions such as Change Subscription and Resume Subscription, 3DS verification will be triggered accordingly.

Previewing the Self Serve Portal 

To preview the Self-Serve Portal, click Preview Checkout/Portal in the Checkout and Self Serve Portal settings page.

Note

The preview checkout in the live site uses the configuration from the test site's checkout.

Disabling the Self Serve Portal 

Click the Disable button under the Portal settings to disable it. Disabling the Self-Serve Portal renders it inaccessible to your customers.

Was this article helpful?
Loading…