The code introduces custom handlers for different billing events like subscription deletion, subscription update, checkout session completion, payment successes and failures, invoice payment, and a generic event handler. These customer handlers allow consumers to add their own custom behaviors when certain billing events occur. This flexibility can be utilized to better adapt the system to various business requirements and rules. Also, the invoice payment event and a generic event handler were added.
Billing / Lemon Squeezy - @kit/lemon-squeezy
This package is responsible for handling all billing related operations using Lemon Squeezy.
Please add the following environment variables to your .env.local file during development:
LEMON_SQUEEZY_SECRET_KEY=
LEMON_SQUEEZY_SIGNING_SECRET=
LEMON_SQUEEZY_STORE_ID=
Add the variables to your production environment as well using your CI.
Webhooks
When testing locally, you are required to set up a proxy to your own local server, so you can receive the webhooks from Lemon Squeezy. You can use ngrok for this purpose, or any other similar service (LocalTunnel, Cloudflare Tunnel, Localcan, etc).
Once you have the proxy running, you can add the URL to your Lemon Squeezy account developer account as the Webhooks URL.
Please set your app configuration URL to the following:
NEXT_PUBLIC_SITE_URL=https://<your-proxy-url>
Replace <your-proxy-url> with the URL provided by the proxy service.
Webhook Events
You must point the webhook to the /api/billing/webhook endpoint in your local server.
Please subscribe to the following events:
order_createdsubscription_createdsubscription_updatedsubscription_expired