Payments

Supported providers:

• Stripe

• LemonSqueezy

Stripe 💰

1. Create Stripe account: https://dashboard.stripe.com/register

2. Important to note. You can switch between "live" and "test" environment with the following toggle. API keys you generate, products you create etc., are bound to the environment you create them in. So if you create API key in test, it won't exist in "live". Same goes for products, coupons, etc.

   
3. Create public and secret key test: https://dashboard.stripe.com/test/apikeys

4. Create webhook key in test: https://dashboard.stripe.com/test/webhooks

5. Set .env variables: STRIPE_PUBLIC_KEY=pk_... STRIPE_SECRET_KEY=sk_... STRIPE_WEBHOOK_SECRET=whsec_... Note: Public key is prefixed with "pk", secret key with "sk" and webhook secret with "whsec".

6. When creating a webhook select a route which handles these, in our case it's: /api/webhook/payment and select events you want to recieve, example:

   
7. If you want to know how to test webhooks locally, without having website online, checkout this section.

8. Now your Stripe setup is ready and you can add products :) Further documentation: https://docs.stripe.com/keys

LemonSqueezy 🍋

1. Create account: https://app.lemonsqueezy.com/dashboard
2. Create api keys. API keys are bound to enviroment. API key created in "test" won't work in "production": https://app.lemonsqueezy.com/settings/api
3. Create webhook key and signing secret: https://app.lemonsqueezy.com/settings/webhooks

   
4. When creating a webhook select a route which handles the incoming events, in our case it's: /api/webhook/payment and select events you want to recieve (see picture above). If you want to know how to test webhooks locally, without having website online, checkout this section.

5. Set .env variables: LEMON_SQUEEZY_API_KEY= LEMON_SQUEEZY_WEBHOOK_SECRET=

6. Now your LemonSqueezy setup is ready and you can add products :) Further documentation: https://docs.lemonsqueezy.com/guides/developer-guide/getting-started

Webhooks (payment)

Webhook allow external services, in this case payment provider, to notify your application when specific events occur, such as successful payments.

Your application listens for incoming webhook events at this route:

/api/webhook/payment

Testing webhooks locally

Since webhooks are usually sent to public URLs, testing them locally requires a workaround. You can use webhook.site to inspect and debug incoming webhooks and test them before going live.

1. Visit webhook.site and copy the generated URL.
2. Configure your webhook sender (e.g., Stripe) to send events to this URL.

3. Install CLI globally: npm install -g @webhooksite/cli

4. Run the listener with the command: whcli forward --token=xxxxxxxxxxx --target=http://localhost:3000/api/webhook.payment (Note: make sure you use correct token. Also use http, rather then https)

5. Make a "test" purchase to trigger the webhook

6. Check the logs in webhook.site to see the payload being sent.