LemonSqueezy setup

LemonSqueezy is for selling digital products — ebooks, templates, software downloads, courses — to a global audience. LemonSqueezy is the “merchant of record”, which means they collect and pay sales tax / VAT on your behalf in every country your customers live in. Huge time saver if you sell internationally.

How LemonSqueezy is different from Polar

With LemonSqueezy you must create each product inside the LemonSqueezy dashboard first. Then Gannako syncs the product details (name, price, image) so it shows on your storefront. You can't create the product in Gannako and have LemonSqueezy pick it up — it has to start in LemonSqueezy.

With Polar, you create the product in Gannako and we push it to Polar. Two opposite directions — pick whichever fits your workflow.

What you'll need

• A LemonSqueezy account (free to sign up).
• A bank account or PayPal for payouts.
• About 20 minutes for setup.

Step 1 — Create your LemonSqueezy store

1. Go to lemonsqueezy.com and sign up.
2. Create your Store — this is what your customers see on receipts and the LemonSqueezy checkout page.
3. LemonSqueezy needs to verify your business before you can take real payments. Submit your details and wait for approval (usually 1-3 working days). You can build out products in test mode while you wait.

Step 2 — Create your products in LemonSqueezy

This is the order that matters: create the product on LemonSqueezy first, then enable LemonSqueezy in Gannako so we can sync them.

1. In LemonSqueezy, click Products → New product.
2. Fill in name, description, price, currency.
3. Upload the digital file the customer receives (PDF, ZIP, video, license key, etc.).
4. Pick the tax category (LemonSqueezy uses this to compute tax in different countries).
5. Publish the product.

Step 3 — Get your API key and Store ID

1. In LemonSqueezy, click Settings → API.
2. Click Create API key. Give it a name like “Gannako”. Copy the key immediately — LemonSqueezy only shows it once.
3. Now click Stores in the left sidebar. Open your store. The Store ID is the number in the URL after /stores/. For example, if the URL is app.lemonsqueezy.com/stores/12345, your Store ID is 12345.

Step 4 — Set up the webhook

LemonSqueezy tells your store when a customer completes a purchase or when a refund happens.

1. In LemonSqueezy, go to Settings → Webhooks.
2. Click Add endpoint, paste the URL above.
3. Tick at least: order_created and order_refunded.
4. LemonSqueezy will give you a signing secret. Copy it — you'll need it in the next step (or the matching field in Gannako, depending on your setup).
5. Save.

Step 5 — Add credentials in Gannako

1. Open Settings → Payments → LemonSqueezy → API Credentials.
2. Paste your API key.
3. Paste your Store ID (the number).
4. Save.
5. Enable LemonSqueezy on the main payments page.

Step 6 — How sync works after this

Once enabled, Gannako fetches your LemonSqueezy products and shows them on your storefront. The flow:

1. You create or edit a product in LemonSqueezy.
2. Gannako pulls the latest details (name, description, price, image) and updates your storefront.
3. A customer adds it to cart and checks out. They're redirected to LemonSqueezy's checkout, which handles the payment, tax, and digital file delivery.
4. LemonSqueezy fires the webhook. Gannako records the order in your admin.

Step 7 — Test, then go live

1. LemonSqueezy starts in test mode. Place a test order using one of their sandbox cards (4242 4242 4242 4242, any future expiry).
2. Confirm the digital file is delivered and the order appears in your Gannako admin.
3. When LemonSqueezy approves your store, switch to live mode. Run one small real order to confirm everything still works.