Setup Lemon Squeezy

This section provides comprehensive guidance on integrating LemonSqueezy as a payment gateway within your Agency Panel.

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.

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

  1. 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).

  1. Next, go to Store → Products and click “Add Product”.

    1. Add a demo product with name, description, and pricing.

  1. After adding a product, go to Settings → API.

  2. 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).

  1. Move to Settings → Webhooks.

  1. 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

    3. Enable the following permissions:

      1. Order_Created

      2. Order_Refunded

      3. Subscription_Created

      4. Subscription_Expired

  1. 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

Do I need a paid LemonSqueezy account to integrate?

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

Why is my API key not being accepted in BotPenguin?

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

What currency should I select for my LemonSqueezy store?

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

Can I add multiple stores in LemonSqueezy?

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

What webhook permissions are mandatory for the setup?

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

How do I test if the integration works?

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

Can I disconnect LemonSqueezy later?

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

If you still have questions for our team, write to us at [email protected]. We’ll get back to you within 48 hours.

PreviousSetup Stripe AccountNextSetup of Ecom Payement Gateway

Last updated

Was this helpful?