Stripe-betalingen direct koppelen aan je Supabase-database in Lovable
Het accepteren van betalingen in een Lovable-app is snel geregeld, maar het veilig bijhouden van abonnementsstatussen in je database vereist een strakke aanpak. In deze gids leggen we uit hoe je Stripe-webhooks betrouwbaar verwerkt en je databasetabellen up-to-date houdt.
lvbl.nl redactie
Bijdrager · lvbl.nl
Als onafhankelijke communitysite zien we op lvbl.nl regelmatig dat makers vertrouwen op de frontend voor het toekennen van functies. Gebruikers krijgen na het afrekenen direct toegang tot pro-functies op basis van een status in de browser. Dat is kwetsbaar. Om een stabiele en veilige applicatie te bouwen, moet de status van een abonnement altijd synchroon lopen met je Supabase-database via een gecentraliseerd proces.
Waarom de frontend alleen niet genoeg is
Het is verleidelijk om Lovable te vragen een actie uit te voeren zodra de gebruiker terugkeert van een betalingsprovider zoals Stripe. Je stuurt de gebruiker terug naar een succes-URL en vraagt de AI om op dat moment de database-kolom is_paid op true te zetten. Dit veroorzaakt twee grote problemen. Ten eerste kan een gebruiker de succes-URL handmatig openen zonder ooit te betalen. Ten tweede kan de internetverbinding van de gebruiker wegvallen vlak nadat de betaling is gelukt, waardoor de app de database-update mist.
Om dit op te lossen werk je met webhooks. Een webhook is een geautomatiseerd bericht dat de betalingsprovider rechtstreeks naar jouw backend stuurt zodra er een gebeurtenis plaatsvindt, zoals een geslaagde betaling of een geannuleerd abonnement. Hier komt geen browser aan te pas. Het is de enige betrouwbare manier om de status van een gebruiker bij te werken.
De juiste databasestructuur neerzetten
Voordat je de webhook-integratie instelt, moet je database klaar zijn om abonnementsgegevens op te slaan. Vraag Lovable niet om simpelweg een vinkje toe te voegen aan de tabel met gebruikersprofielen. Een abonnement heeft namelijk een levenscyclus met verschillende toestanden zoals actief, verlopen, betaling mislukt of opgezegd.
Maak een aparte tabel aan voor abonnementen, of vraag Lovable dit voor je te doen met een duidelijke prompt. Zorg dat de tabel minimaal de volgende kolommen bevat: id, user_id, stripe_customer_id, stripe_subscription_id, status en current_period_end. Door de user_id te koppelen aan de auth.users-tabel van Supabase, koppel je de betaling direct aan het account van de ingelogde gebruiker.
Webhooks ontvangen via Supabase Edge Functions
Omdat Lovable op de achtergrond Supabase gebruikt voor databeheer en back-end functionaliteit, zijn Supabase Edge Functions de aangewezen plek om webhooks te ontvangen. Een Edge Function is een klein stukje servercode dat snel uitgevoerd wordt in de cloud.
Vraag aan Lovable: "Maak een Edge Function genaamd stripe-webhook die inkomende POST-verzoeken verwerkt en het Stripe-handtekeningteken valideert." Het valideren van het handtekeningteken (de webhook secret) is cruciaal. Hiermee controleert je Edge Function of het bericht daadwerkelijk van Stripe komt en niet van een derde partij die valse betalingsberichten verstuurt. Het geheim bewaar je in de omgevingsvariabelen van je project en deel je nooit in de frontend-code.
Lovable de juiste instructies geven voor de logica
Wanneer de Edge Function de webhook ontvangt, moet de code de database bijwerken. Lovable kan deze code uitstekend genereren als je specifiek bent in je instructies. Richt je op de belangrijkste Stripe-gebeurtenissen.
Bij het event checkout.session.completed laat je de Edge Function de stripe_customer_id en de abonnementsstatus opslaan in de subscriptions-tabel. Bij customer.subscription.updated werk je de status en de verloopdatum bij. En bij customer.subscription.deleted pas je de status aan naar verlopen of geannuleerd. Door Lovable precies te vertellen welke gebeurtenissen naar welke databasetabellen moeten schrijven, voorkom je dat de AI aannames doet die je databasestructuur in de war schoppen.
Toegangsrechten beveiligen met Row Level Security
Nadat de gegevens correct in de database belanden, moet de app bepalen wie toegang heeft tot specifieke functies. Vertrouw hierbij niet alleen op een controle op gebruikersniveau in je React-componenten. Als de database-query's niet afgeschermd zijn, kunnen kwaadwillenden nog steeds data opvragen via het netwerkverkeer.
Gebruik Row Level Security (RLS) binnen Supabase. Dit zijn regels die op databaseniveau bepalen wie welke rijen mag lezen of aanpassen. Je kunt Lovable vragen om een RLS-policy te schrijven die controleert of de ingelogde gebruiker een actieve rij heeft in de subscriptions-tabel met een current_period_end die in de toekomst ligt. Pas als de database bevestigt dat het abonnement actief is, wordt de opgevraagde data teruggestuurd naar de gebruiker.
Fouten opsporen en testen in de praktijk
Testen is bij betalingsintegraties essentieel. Maak altijd gebruik van de testmodus van je betalingsprovider voordat je live gaat. Met hulpprogramma's zoals de Stripe CLI kun je lokaal of op een staging-omgeving webhooks simuleren zonder echt geld uit te geven.
Controleer in het Supabase-dashboard bij de logs van je Edge Functions of de webhooks binnenkomen met een statuscode 200. Zie je statuscodes in de 400 of 500, dan is er iets mis met de authenticatie van het bericht of het wegschrijven naar de database. Vraag Lovable in dat geval om foutafhandeling met try-catch-blokken en duidelijke console logs toe te voegen aan de Edge Function, zodat je in het dashboard exact kunt zien op welke regel het misgaat.
Conclusie en volgende stappen
Het opzetten van een betalingssysteem in Lovable vraagt iets meer aandacht dan alleen een mooie knop genereren. Door te vertrouwen op Edge Functions, het valideren van webhooks en het afdwingen van databeveiliging via RLS, bouw je een applicatie die schaalbaar en veilig is. Als onafhankelijk platform benadrukken we op lvbl.nl graag dat het begrijpen van deze architectuur het verschil maakt tussen een aardig prototype en een verkoopbaar SaaS-product. Neem de tijd om de stroom van betaling naar database grondig te testen voordat je je eerste klanten verwelkomt.
Vond je dit fijn?
Geef een hartje en deel het met een andere Lovable-fan.