Build a Recharge-hosted customer portal

Create a custom Recharge-hosted customer portal and give customers complete control over their subscriptions.

Build a custom Recharge-hosted portal and give customers the tools they need to manage their subscriptions. The Recharge-hosted portal is the easiest and fastest way to integrate a customer portal experience through Recharge.



  • Custom


Redirect customers to an existing page using minimal API calls while ensuring the existing infrastructure performs the technical heavy lifting to manage customers' subscriptions.

Building a Recharge-hosted customer portal requires two steps"

  1. Make a middleware call to the Recharge Customers API to fetch the customer's hash value. The hash value acts as an authenticator to authorize the customer to access the relevant customer portal. After retrieving the customer's hash value, create a URL that redirects the customer to the Recharge customer portal.
  2. Insert a Manage Subscriptions link on the My Account page (or an equivalent page depending on the platform) that navigates customers to the Recharge portal.

Step 1 - Fetch the customer hash

Using middleware, retrieve the customer hash when the customer navigates to the My Account page. Only the customer ID is required to retrieve this information. The redirect URL uses a hash property, found in the API call response.

import requests

headers = {"X-Recharge-Access-Token": "your_api_token"}
url = ""

result = requests.get(url, headers=headers)

See Retrieve a customer in the Recharge API Reference Guide for additional information.

Step 2 - Add the Manage Subscriptions link to the My Account page

After locating the customer hash, add the following code to your theme file to add the manage subscriptions link:

  <a href="https://<recharge-subdomain><customer_hash>/subscriptions">
    Manage Subscriptions

Customers are redirected to the Recharge hosted customer portal when they interact with this link.



Using the Shopify Checkout Integration? See Adding and adjusting the 'Manage Subscriptions' link to the customer account in Shopify in the Recharge Help Center for additional information.

Need Help? Contact Us