Switch to Lemon Squeezy

Lemon Squeezy is an all-in-one platform for running your SaaS business. It handles payments, subscriptions, global tax compliance, fraud prevention, multi-currency, and more. Here’s how to switch the default payment processor from Stripe to Lemon Squeezy.

​

1. Swap out the required dependencies

First, uninstall the existing dependencies from the Payments package…

pnpm remove stripe --filter @repo/payments

… and install the new dependencies…

pnpm add @lemonsqueezy/lemonsqueezy.js --filter @repo/payments

​

2. Update the environment variables

Next, update the environment variables across the project, for example:

NEXT_PUBLIC_LEMON_SQUEEZY_API_KEY=""

Additionally, replace all instances of STRIPE_SECRET_KEY with LEMON_SQUEEZY_API_KEY in the packages/env/index.ts file.

​

3. Update the payments client

Initialize the payments client in the packages/payments/index.ts file with the new API key. Then, export the lemonSqueezySetup function from the file.

import { env } from '@repo/env';
import { lemonSqueezySetup } from '@lemonsqueezy/lemonsqueezy.js';

lemonSqueezySetup({
  apiKey,
  onError: (error) => console.error("Error!", error),
});

export * from '@lemonsqueezy/lemonsqueezy.js';

​

4. Update the payments webhook handler

Remove the Stripe webhook handler from the API package…

rm apps/api/app/webhooks/stripe/route.ts

… and create a new webhook handler for Lemon Squeezy:

import { NextResponse } from 'next/server';

export const POST = async (request: Request) => {
  return NextResponse.json({ message: 'Hello World' });
};

There’s quite a lot you can do with Lemon Squeezy, so check out the following resources for more information:

​

5. Use Lemon Squeezy in your app

Finally, use the new payments client in your app.

import { getStore } from '@repo/payments';

const Page = async () => {
  const store = await getStore(123456);

  return (
    <pre>{JSON.stringify(store, null, 2)}</pre>
  );
};