> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/connect/recharge.md).

# Recharge

Enter your Recharge subdomain and sign in to connect Recharge to MESA, then automate subscription workflows from your store.

## Connection

When setting up your first workflow with Recharge, you will need to create a [connection](https://docs.getmesa.com/going-further/credentials/) through MESA's Recharge connector. Enter your subdomain in the Recharge Subdomain field and click the Sign in with Recharge button to complete the process.

<figure><img src="https://docs.getmesa.com/assets/image%20%28574%29.png" alt="Screenshot of the MESA Recharge connection setup, enter your subdomain in the Recharge Subdomain field. Spotlight the Sign in with Recharge button."><figcaption></figcaption></figure>

Once redirected, scroll until you see a blue Install button and click on it.

<figure><img src="https://docs.getmesa.com/assets/image%20%28474%29.png" alt="Screenshot of the Recharge install page after being redirected from MESA. Spotlight the blue Install button."><figcaption></figcaption></figure>

:::danger
If you're redirected to a 'Not Found' message, it means Recharge is not installed on the Shopify store where MESA is currently set up.
:::

:::note
The Recharge app utilizes [Recharge’s SCI API](https://developer.rechargepayments.com/2021-11/).
:::

## Configure

### Getting Shopify Data from Recharge Actions

Recharge has its own system for identifying orders, customers, and products. To reference Shopify orders, customers, or products within a Recharge action, you must use the "external ecommerce" variables.

For example, select the "Recharge > External Order ID > Ecommerce" variable to get the Shopify data for a Recharge order.

<figure><img src="https://docs.getmesa.com/assets/image%20%28575%29.png" alt="Screenshot of the MESA variable selector in a Recharge action, selecting the Recharge External Order ID Ecommerce variable to get Shopify data for a Recharge order. Spotlight the External Order ID Ecommerce variable."><figcaption></figcaption></figure>

### Orders Count

When using the Orders Count action, be sure to add a Filter step afterward to ensure the comparison conditions for the total number of orders meet your desired criteria.

<figure><img src="https://docs.getmesa.com/assets/EF-recharge-steps-2.png%20-%20Step%202.png" alt="Screenshot of a MESA workflow using the Recharge Orders Count action with a Filter step added afterward to check the total number of orders. Spotlight the Filter step."><figcaption></figcaption></figure>

The Orders Count action receives the total number of orders placed by a customer's email address.

## Technical Notes

### Parameters

* limit: Get List actions in Recharge default to a limit of 50, but the maximum limit can be set at 250 with parameters. Click [here](https://developer.rechargepayments.com/2021-11/cursor_pagination) for more information.
* sort\_by: Please refer to this [table](https://developer.rechargepayments.com/2021-11/sorting) for more details.

:::note
View Recharge templates and tutorials [here](https://www.getmesa.com/apps/recharge/integrate)!
:::
