Hosted Self-Serve PortalConfigure Portal

Configure Portal

This guide walks you through enabling and configuring the BillHive Hosted Self-Serve Portal for your customers.

Enabling the Portal

To activate the self-serve portal:

  1. Navigate to Settings > Hosted Pages > Self-Serve Portal.
  2. Click Enable.

Once enabled, customers can sign in to the portal you embed on your site. When the portal is off, the portal sessions API, the email code check, the account choice and the portal itself answer “The portal is turned off for this product.” A request for an email code still gets the usual “we have sent a code” reply, but no email goes out. Customers already in the portal go back to the sign-in screen with that message.

Access Methods

Customers can get into the portal in two ways. See Integrate Portal for the embed code.

After a customer signs in to your application, your server asks BillHive for a portal session and gives the token to the embedded portal. The customer sees no second login.

Benefits:

  • Seamless experience — no duplicate login
  • You control authentication
  • More secure for production use

Email code

The customer enters their email address and receives a 6-digit code. The code is valid for 10 minutes. Nothing else is needed on your side.

Best for: Quick setup or when you don’t have your own authentication system.

General Settings

Invoice Downloads

Enable customers to view and download historical invoices as PDF from within the portal.

Note: Invoices may be hidden if any customer in an account hierarchy is unlinked.

Subscription Modifications

Allow customers to modify their subscriptions directly from the portal. You have granular control over what changes are permitted:

SettingDescription
Allowed subscription statesDefine which states allow changes — active, non-renewing, or in trial
Change timingImmediate or end-of-term
Plan changesAllow customers to switch between plans with configurable proration rules
Quantity adjustmentsLet customers increase or decrease subscription quantity
Add-on managementAllow adding or removing add-ons, with optional “recommended” labels
Coupon managementEnable customers to apply or remove coupons

Cancellation Settings

Configure how customers can cancel their subscriptions:

  • Cancellation timing — Immediate, end-of-term, or let the customer choose
  • Specific date scheduling — Allow customers to pick a cancellation date
  • Feedback collection — Prompt customers for a reason during cancellation
  • Reactivation — Allow customers to reactivate cancelled subscriptions
  • Remove scheduled changes — Let customers undo pending cancellations

Pause & Resume

Allow customers to pause their subscriptions temporarily:

OptionDescription
Indefinite pauseSubscription stays paused until the customer manually resumes
Fixed-duration pauseAutomatically resumes after a set period (max 90 days)
Customer-configurableLet the customer choose the pause duration within your defined limits

Payment Method Management

  • Allow customers to add new payment methods
  • Allow removal of the primary payment method
  • Support for 3D Secure (3DS) verification during payment method updates

3D Secure (3DS) Support

The portal supports 3DS authentication for secure transactions:

  • A minimal authorization amount is temporarily charged during payment method updates, then automatically voided.
  • Subscription changes or resume actions that trigger an immediate charge will go through 3DS verification when applicable.

Look and options

Go to Settings > Hosted Pages, pick the product, and open Hosted Self-Serve Portal. Then click Customize:

  • Brand colour, font and corners: the same choices as the pricing table and checkout. Shades and readable text colours are worked out for you.
  • Customers can: turn each action on or off. The actions are edit subscription, change plan, change billing frequency, add add-ons, convert a trial, renew, reactivate, pause and resume, and cancel. Convert trial and reactivate start off.

The preview shows a sample customer, and you can click through every screen. Click Save to apply the settings.

Advanced Settings

Display Add-ons and Charges

To show add-ons and one-time charges in the portal, ensure “Display in Self-Serve Portal” is enabled for each item in your product catalog setup.

Add-ons marked as recommended will display with a “Recommended” badge in the portal, encouraging adoption.

Preview & Testing

Use the Preview Portal option in your settings page to test the portal experience before going live.

Note: The preview uses your test environment configuration.

Disabling the Portal

To disable the portal and prevent customer access:

  1. Navigate to Settings > Hosted Pages > Self-Serve Portal.
  2. Click Disable.

Customers will no longer be able to access the portal once disabled.