Features > Payment Setup > Lemon Squeezy

Setup

1. Sign up to create a new account on Lemon Squeezy and activate payments

2. In your [Settings] > [General], provide the required fields such as URL, app name, logo, support email, etc.

3. In your [Settings] > [General], toggle on Tax-inclusive pricing If you intend to include tax in your final prices

4. In your [Settings] > [Domains], Include your domain if you plan to use a custom domain for the checkout page.

5. Turn ON Test Mode

6. Generate a new product and copy the variant ID (e.g., 123456) in config.lemonsqueezy.plans[0].variantId inside the config.ts file.

7. In your [Settings] > [Stores], grab your store id and paste it into LEMONSQUEEZY_STORE_ID in .env

8. In your [Settings] > [API], create and copy your API key, then paste it into LEMONSQUEEZY_API_KEY in .env

9. To configure the webhook locally, Lemon Squeezy should be able to call your local endpoint in some manner. We are going to use NGROK for that purpose. Register a new account in ngrok and get your Authtoken from this page.
Execute the following commands to make your service publicly available:

brew install ngrok/ngrok/ngrok
ngrok config add-authtoken [USE YOUR AUTH TOKEN]
ngrok http 3000

Copy the Public URL from the output. We'll use it in the next step.

10. To configure the webhook locally, follow the steps in [Settings] > [Webhooks]. Create a webhook and set up a signing secret. Grab the signing secret and include it into LEMONSQUEEZY_WEBHOOK_SECRET in .env
Set up Callback URL as follows:
https://[USE YOUR PUBLIC URL].ngrok-free.app/api/webhook/lemonsqueezy
Turn ON following updates in:
order_created, subscription_updated, subscription_cancelled, subscription_payment_success

Ready for production?

1. Turn OFF Test Mode in the Lemon Squeezy Dashboard
2. In your [Settings] > [API], copy your API Key and add it to LEMONSQUEEZY_API_KEY in your environment variables for production.
3. In your [Settings] > [Webhooks]. Set up your domain + /api/webhook/lemonsqueezy. Selectorder_created, subscription_updated, subscription_cancelled, subscription_payment_success events (or more if needed). Copy the signing secret and insert it intoLEMONSQUEEZY_WEBHOOK_SECRET in your environment variables for production.

Create a Checkout

From the front-end, utilize the ButtonCheckout component to automatically generate a checkout session, whether it's for a one-time payment or a subscription.

Webhooks & subscription handling

Our API listens to Lemon Squeezy selected webhook events and updates the user accordingly. It adds credits to credits column of user record in the users table. You can incorporate your own business logic as needed to the/api/webhook/lemonsqueezy API endpoint (Add credits to a user's account, send an email with a paid e-book, and so on.)