# Integrate with Recharge

> Recharge  is a subscription payments management platform that integrates with Shopify, and allows merchants to set up dynamic recurring billing for their sto...

Source: https://help.kustomer.com/en_us/integrate-with-recharge-rJTa3lNK

Last updated: 2026-07-06T17:03:20.701Z

[Recharge](https://rechargepayments.com/) is a subscription payments management platform that integrates with Shopify, and allows merchants to set up dynamic recurring billing for their storefronts.

Integrate Recharge with Kustomer to allow agents to view subscription data from the Kustomer timeline and launch the Recharge dashboard.

**Who can access this feature?**

**User types**

Admins can set up this integration.

  

### In this article

*   [Prerequisites](#prerequisites)
*   [How does Recharge work with Kustomer?](#features)
*   [Create a Recharge API token](#api)
*   [Install the Recharge app](#install)

### Prerequisites

Before starting the integration process, you must already have a Shopify store set up in Recharge. You will also need to have access to the [Recharge API](https://docs.rechargepayments.com/docs). If this is your first time using the Recharge API, you will need to [request access to this feature](https://support.rechargepayments.com/hc/en-us/articles/1500003591542-Recharge-API-and-the-Shopify-Checkout-Integration).

### How does Recharge work with Kustomer?

Kustomer's Recharge integration involves a workflow that ingests a Recharge subscription object received via a webhook, which creates a custom object from that subscription. The resulting custom object is displayed to agents in the Kustomer timeline.

Agents can view subscription data from the timeline or Insight Panel. Agents can also use the **View in Recharge** button in the timeline to launch their Recharge dashboard where they can manage the subscription.

![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/dd54aa2adb7e3c1d3c4c47588599504f.png)

**Note:** This app integration can connect to one Recharge account. If you need recommendations for integrating with more than one Recharge account, please contact our support team.

### Create a Recharge API token

The first step in this integration will be to create an API token in Recharge for Kustomer to use.

Sign in to your Recharge admin page, then go to **Integrations > Enabled integrations > API tokens** to [create an API token](https://support.rechargepayments.com/hc/en-us/articles/360008829993-Recharge-API-#h_f3b493d2-ce6e-4042-b905-afd6bafde0f5) for Kustomer that has Read access to Subscriptions and Customers. Leave this browser tab open to access the API token, as you will use it in Kustomer in the next step.  
  
![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/b8041cee93c47cd063c14cd09faa6757.png)

### Install the Recharge app

Next, you'll install the Recharge app from within the Kustomer App Directory.

1.  Go to **Apps**![](https://cdn.kustomerhostedcontent.com/media/570fad9d9001bc1000163b28/2be04c82b2fd9485ac06d3cc81ed39a0.png)and select **Explore Directory**.
2.  Search for **Recharge** in the App Directory, and then select **Install**.
3.  You'll be asked to provide some integration details. Paste the **Recharge API token** you created earlier where prompted.
4.  In the **Shopify store subdomain** field, enter the prefix of your Shopify URL and omit the .`myshopify.com`. For example, if your Shopify URL is _https://acme-usa.myshopify.com_, you would enter `acme-usa`.
5.  Select **Install** to finish setup and installation.
    

With Recharge set up and installed, your agents will now be able to view Recharge subscription information from the Kustomer timeline.

### **Display Recharge attributes on Conversation or Customer Insight Cards**

By default, Recharge subscription data appears on the Recharge Subscription event in the customer timeline. To display Recharge attributes on Conversation or Customer Insight Cards:

1.  From the left navigation, click ****Settings****. In the ****Settings**** page, click ****Platform****, then select ****Klasses****.
2.  Select the ****recharge-subscription**** Klass.
3.  Click ****Create Attribute**** and add the fields you want to display (for example, `statusStr` for subscription status, `quantityNum`for quantity).
    1.  Use **Guidance** to show AI how to understand and use the attribute data. 
    2.  Check **Mask the data in this attribute** if the attribute's data is considered sensitive. 
4.  Navigate to the Insight Card for the Conversation or Customer Klass and click ****Edit**** > ****View Code****.
5.  Add `BasicField` components referencing the new attributes. Use the `custom.` prefix and the correct suffix convention:

*   `Str` for text fields
*   `Num` for number fields
*   `At` for date fields

Example: `<BasicField label='Subscription Status' value={_.get(kobject, 'custom.statusStr')} />`
