Skip to main content

🎯 Lemon Squeezy Setup - Next Steps

✅ What's Already Done​

  • ✅ API Key: Configured in .env
  • ✅ API Server: Running on http://localhost:4001
  • ✅ Download System: Working
  • ✅ Email Templates: Ready with PhotoFlow SEO branding
  • ✅ Pro Package: Built and ready for distribution

📋 What You Need to Do (15 minutes)​

Step 1: Get Store ID (2 mins)​

  1. Go to: https://app.lemonsqueezy.com/settings/api
  2. Look for "Store ID" at the top (it's a number like 12345)
  3. Copy it

Step 2: Create PhotoFlow SEO Product (5 mins)​

  1. Go to: https://app.lemonsqueezy.com/products

  2. Click "+ New Product"

  3. Fill in:

    Name: PhotoFlow SEO - Site License
    Price: 99.00 USD
    Billing: Annual subscription

    Description:
    AI-powered alt text, captions, and ImageObject schema for photo galleries.

    Includes:
    • Automatic SEO-optimized alt text
    • AI-generated captions  
    • ImageObject schema for search engines
    • Priority email support
    • All updates while active

  4. CRITICAL - Enable License Keys:

    • Scroll to "License Keys" section
    • Toggle ON
    • Format: Custom
    • Prefix: pswp_prod_
    • Length: 32
    • Activation limit: Unlimited

  5. Click "Save Product"

  6. Copy Product ID from URL: app.lemonsqueezy.com/products/[NUMBER]

Step 3: Set Up Webhook (3 mins)​

  1. Go to: https://app.lemonsqueezy.com/settings/webhooks
  2. Click "+ Add endpoint"
  3. Fill in:
    URL: http://localhost:4001/api/webhooks/lemonsqueezy
    Events: ✅ order_created
           ✅ subscription_created  
           ✅ license_key_created
  4. Click "Generate" for webhook secret
  5. Copy the webhook secret (starts with whsec_...)

Step 4: Update .env File (2 mins)​

Edit your .env file and replace these lines:

# Replace these with your actual values:
LEMON_SQUEEZY_STORE_ID=12345                    # From Step 1
LEMON_SQUEEZY_PRODUCT_ID=67890                  # From Step 2
LEMON_SQUEEZY_WEBHOOK_SECRET=whsec_abc123...   # From Step 3

Step 5: Test Purchase (3 mins)​

  1. In Lemon Squeezy, toggle "Test Mode" (top right - orange banner)

  2. Go to your product and click "Get checkout link"

  3. Open the link in incognito/private window

  4. Purchase with test card:

    • Card: 4242 4242 4242 4242
    • Expiry: 12/25
    • CVC: 123
    • Email: test@example.com

  5. Check your API server console - should see:

    📨 Webhook received: order_created
    📧 [MOCK] License email would be sent to: test@example.com
    License Key: pswp_prod_test123...

🎉 You're Done!​

Once you complete these steps, you'll have:

  • ✅ Payment Processing: Lemon Squeezy checkout
  • ✅ License Delivery: Automated email with license key
  • ✅ Package Downloads: Secure .tgz distribution
  • ✅ Customer Portal: Self-service license management

Ready to accept real customers! 🚀

🆘 Need Help?​

Quick Links:

Test Your Setup:

# Check API server
curl http://localhost:4001/health

# Check license endpoint  
curl http://localhost:4001/api/license/health

# Check download system
curl http://localhost:4001/api/download/latest

Your PhotoFlow SEO business is ready to launch! 🎊