# Setup Lemon Squeezy

### What is LemonSqueezy?

LemonSqueezy is a payment gateway platform designed to simplify digital product sales and subscription management. Integrating LemonSqueezy with the Agency Panel allows seamless payment processing, automated billing, and synchronized product management between your customer plans and LemonSqueezy store.

***

### Benefits of LemonSqueezy Integration

* 💳 Simplifies online payment collection and subscription billing.
* ⚙️ Automates plan activation and renewal workflows in your Agency.
* 🌐 Supports global currencies for flexible billing options.
* 📊 Centralizes revenue tracking and product sales analytics.
* 🧩 Enables scalable monetization through a unified integration.

***

### How to Use LemonSqueezy Integration

Follow the steps below to configure LemonSqueezy as your payment gateway in the BotPenguin Agency Panel.

***

#### A. Connecting LemonSqueezy from Agency Panel

1. Go to your **Agency Panel** and click on **“Configuration”** from the left menu.
2. Select **“Integrations”** and either search for **LemonSqueezy** or scroll down to locate it.
3. Click on **“Connect”** to begin the setup process.
4. You will now see input fields asking for integration credentials that must be obtained from your LemonSqueezy account.

***

#### B. Setting up LemonSqueezy

1. Visit the **LemonSqueezy website** (<https://www.lemonsqueezy.com/>) and either **sign up** or **log in** to your account.
2. After logging in, **create a new store** by clicking the **“Add New Store”** button from the bottom-left panel.
   * Enter the **store name**, **store URL**, and **country**.

<figure><img src="/files/XDxUDocS693rUawzezWQ" alt=""><figcaption></figcaption></figure>

3. Once the store is created, navigate to **Settings → General**.

<figure><img src="/files/hNzj0eYMf6EmCddgYngc" alt=""><figcaption></figcaption></figure>

4. Scroll to the **Currency** field and choose the appropriate currency for your store.
   1. Ensure it matches the customer plan currency used in BotPenguin (e.g., USD → USD).

<figure><img src="/files/9hWlDBwSK2VczEQrWhpz" alt=""><figcaption></figcaption></figure>

5. Next, go to **Store → Products** and click **“Add Product”**.
   1. Add a demo product with **name**, **description**, and **pricing**.

<figure><img src="/files/u0corTryRhi7ddA6RXCf" alt=""><figcaption></figcaption></figure>

6. After adding a product, go to **Settings → API**.
7. Click the **“+”** button to generate a new API key.
   1. Enter a name (e.g., “Test”) and click **“Create API Key.”**
   2. Copy the API key immediately (it will only be visible once).

<figure><img src="/files/8X8rAsednsem87Z1jNvT" alt=""><figcaption></figcaption></figure>

8. Move to **Settings → Webhooks**.

<figure><img src="/files/9cEcdkBuN0C1NohLPjlK" alt=""><figcaption></figcaption></figure>

9. Click the **“+”** icon to create a new webhook and fill the following details:
   1. **Callback URL:** <https://api.v7> .botpenguin.com/lemonsqueezy/webhook
   2. **Signing Secret:** `BOTPENGUIN`&#x20;
   3. Enable the following permissions:
      1. Order\_Created
      2. Order\_Refunded
      3. Subscription\_Created
      4. Subscription\_Expired

<figure><img src="/files/lhIHjtKUkPiQzv6i5pRk" alt=""><figcaption></figcaption></figure>

10. Save the webhook configuration.

***

#### C. Finalizing Integration in BotPenguin

1. Return to your **Agency Panel → Integrations → LemonSqueezy.**
2. Enter the **API Key** obtained from LemonSqueezy.
3. Select the **Store ID** and **Product ID** from the dropdowns that appear.
4. Click **“Connect”** to successfully integrate LemonSqueezy with BotPenguin.

***

#### D. Configuring Customer Plans for LemonSqueezy Payments

1. Go to **Customer Plans → Configurations.**
2. Expand the **Currency and Payments** section.
3. Choose the **currency** used in your LemonSqueezy store.
4. Select **LemonSqueezy** as the **Payment Gateway**.
5. Save the settings to enable payments through LemonSqueezy.

***

### LemonSqueezy FAQs

<details>

<summary>Do I need a paid LemonSqueezy account to integrate?</summary>

No, you can start with a free LemonSqueezy account. However, for live transactions and higher sales limits, upgrading may be required.

</details>

<details>

<summary>Why is my API key not being accepted in BotPenguin?</summary>

Ensure you copied the API key immediately upon creation and pasted it correctly. API keys are visible only once in LemonSqueezy.

</details>

<details>

<summary>What currency should I select for my LemonSqueezy store?</summary>

Always select the same currency as your BotPenguin customer plans to avoid payment errors or mismatched billing.

</details>

<details>

<summary>Can I add multiple stores in LemonSqueezy?</summary>

Yes, LemonSqueezy allows multiple stores. Ensure you select the correct **Store ID** during BotPenguin integration.

</details>

<details>

<summary>What webhook permissions are mandatory for the setup?</summary>

The required webhook permissions are **Order Created**, **Order Refunded**, **Subscription Created**, and **Subscription Expired**.

</details>

<details>

<summary>How do I test if the integration works?</summary>

Create a demo product and perform a test purchase to verify if BotPenguin records the payment and subscription data correctly.

</details>

<details>

<summary>Can I disconnect LemonSqueezy later?</summary>

Yes, you can disconnect it anytime from the **Integrations** section in your Agency Panel without affecting existing records.

</details>

***

If you still have questions for our team, write to us at [**support@botpenguin.com**](mailto:support@botpenguin.com). We’ll get back to you within 48 hours.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://partners.botpenguin.com/partner-platform-guidelines/integration-setup/setup-lemon-squeezy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.