7ebff31475
Version 3 of the kit: - Radix UI replaced with Base UI (using the Shadcn UI patterns) - next-intl replaces react-i18next - enhanceAction deprecated; usage moved to next-safe-action - main layout now wrapped with [locale] path segment - Teams only mode - Layout updates - Zod v4 - Next.js 16.2 - Typescript 6 - All other dependencies updated - Removed deprecated Edge CSRF - Dynamic Github Action runner
43 lines
2.4 KiB
Plaintext
43 lines
2.4 KiB
Plaintext
---
|
|
status: "published"
|
|
title: 'Troubleshooting billing issues in the Next.js Supabase kit'
|
|
label: 'Billing'
|
|
order: 3
|
|
description: 'Troubleshoot issues related to billing in the Next.js Supabase SaaS kit'
|
|
---
|
|
|
|
## Cannot create a Checkout
|
|
|
|
This happen in the following cases:
|
|
|
|
1. **The environment variables are not set correctly**: Please make sure you have set the following environment variables in your `.env` file if locally - or in your hosting provider's dashboard if in production
|
|
2. **The plan IDs used are incorrect**: Make sure to use the exact plan IDs as they are in the payment provider's dashboard.
|
|
|
|
## The Database is not updated after subscribing to a plan
|
|
|
|
This may happen if the webhook is not set up correctly. Please make sure you have set up the webhook in the payment provider's dashboard and that the URL is correct.
|
|
|
|
Common issues include:
|
|
1. **The webhook is not set up correctly**: Please make sure you have set up the webhook in the payment provider's dashboard and that the URL is correct.
|
|
2. **The plan IDs used are incorrect**: Make sure to use the exact plan IDs as they are in the payment provider's dashboard.
|
|
3. **The environment variables are not set correctly**: Please make sure you have set the following environment variables in your `.env` file if locally - or in your hosting provider's dashboard if in production
|
|
|
|
### Locally
|
|
|
|
If working locally, make sure that:
|
|
|
|
1. **Stripe**: If using Stripe, that the Stripe CLI is up and running
|
|
2. **Lemon Squeezy**: If using Lemon Squeezy, that the webhook set in Lemon Squeezy is correct and that the server is running. Additionally, make sure the proxy is set up correctly if you are testing locally (see the Lemon Squeezy documentation for more information).
|
|
|
|
### Production
|
|
|
|
If working in production, make sure that:
|
|
|
|
- The Stripe/Lemon Squeezy webhooks are set up correctly and are being sent to the correct URL. The URL must be publicly accessible. If the URL is not publicly accessible, you will not be able to receive webhooks from Stripe.
|
|
- If the webhooks are being sent, please read the logs in your hosting provider to see if there are any errors related to webhooks.
|
|
- If after reading the logs, the webhooks are not being sent, please contact support by posting relevant information in the Support Ticket.
|
|
|
|
When opening a support ticket, please make sure to include:
|
|
1. The logs being sent from Stripe in the Stripe Dashboard
|
|
2. The logs in your hosting provider
|
|
3. Any error messages you may have received |