> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recharge

> Connect your Recharge subscription events to Converge

## Installation instructions

<Steps>
  <Step title="Navigate to the Recharge Admin Dashboard">
    1. In your Shopify Admin Dashboard, navigate to `Apps` > `Recharge`.
    2. Verify in the menu bar that you have access to the **API Tokens** submenu.
       <Note>Only Storeowners can view and access API tokens by default. If you do not see the option for API tokens, you will have to ask your storeowners to update your account permissions. </Note>
  </Step>

  <Step title="Create your token">
    3. Click on **Create an API Token**.
    4. For each of the scopes, provide `Read access`.
    5. Click on **Save** and copy your token.
  </Step>

  <Step title="Create a new Server-side source in Converge">
    6. In Converge, click on **Create a new source**
    7. Pick *Server-side* from the modal
    8. Name your source: e.g. `{Storename} Subscriptions`
  </Step>

  <Step title="Connect the Source">
    9. Enter the Recharge API Token.
    10. Click on **Create Source**.
  </Step>
</Steps>

<Note>This source is webhook-based, meaning historical data won't be synced in.</Note>

***

## Event spec

This integration auto-tracks the following events on the server with all properties available according to the [Converge event spec](/sources/converge-spec).

| Event Name                                                              | Event Description                           |
| ----------------------------------------------------------------------- | ------------------------------------------- |
| [Started Subscription](/sources/converge-spec#started-subscription)     | When a customer starts a subscription.      |
| [Cancelled Subscription](/sources/converge-spec#cancelled-subscription) | When a customer cancels their subscription. |

[//]: # "TODO: The RecurringSubscriptionPayment event and Skipped Subscription should be included"

### Sales channels

More on sales channels can be found [here](/sources/concepts/sales-channels).

The following events are mapped to the following sales channel types:

| Recharge                            | Converge Mapping       | Description                                                     |
| ----------------------------------- | ---------------------- | --------------------------------------------------------------- |
| Started Subscription                | web                    | Browser-based interactions and actions                          |
| Placed Recurring Subscription Order | subscription\_contract | Automated events related to subscription renewals or contracts. |
| Cancelled Subscription              | subscription\_contract |                                                                 |
| Activated Subscription              | subscription\_contract |                                                                 |
| Paused Subscription                 | subscription\_contract |                                                                 |
| Skipped Subscription                | subscription\_contract |                                                                 |
| Unskipped Subscription              | subscription\_contract |                                                                 |