For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /nl/docs/web/billing.md (or send Accept: text/markdown).
Betalingen en abonnementen
Stripe-checkout, planbeheer en de entitlement-grens.
Kies en test uw betaaldienst
Facturering verwerkt betalingen. Toegangsrechten worden afzonderlijk opgeslagen als rechten. Voltooi de permanente accountconfiguratie en open vervolgens /billing in de actieve webapp om de abonnementsinterface te bekijken. Met BILLING_PROVIDER=local onderzoekt u lokaal gedrag in plaats van echt geld te verzamelen.
Kies een ondersteunde betalingsprovider, volg de installatiehandleiding, maak uw eigen testproduct en prijs aan en kopieer de benoemde serverinstellingen naar apps/web/.env.local.. Sla de webserver op en start deze opnieuw op. Voltooi één keer afrekenen met behulp van de sandbox-instructies van die provider en inspecteer vervolgens de toegangsstatus van de werkruimte nadat de webhook van de provider arriveert. Een webhook is het ondertekende bericht van de provider aan uw server over een betalingsgebeurtenis.
Een succespagina alleen ontgrendelt geen functies. Als het afrekenen is voltooid maar de toegang inactief blijft, controleer dan de webhooklevering van de provider en de gebeurtenisverwerking van uw server voordat u de betaling herhaalt. Testannulering en verlopen toegang ook. Voor telefonische aankopen wordt de afzonderlijke RevenueCat/winkel-configuratie gebruikt, niet deze webkassa.
Webbilling
De webapplicatie ondersteunt de factureringsprovider die u selecteert met BILLING_PROVIDER; Streep is een optie. Open/facturering voor webabonnementen en abonnementsbeheer. Volg de handleiding van de geselecteerde provider om de inloggegevens voor de server, product- of prijs-ID's en webhookverificatie-instellingen in de overeenkomende test- of live-omgeving in te stellen.
Autoriseer via entitlements
Een checkoutredirect is geen bewijs van actieve toegang. De server-owned entitlement beslist of een workspace een betaalde capability mag gebruiken. Check die entitlement op de actiegrens, zelfs wanneer de interface de actie al verbergt.
Verifieer de lifecycle
Gebruik sandboxevents om activatie, updates, annulering en webhookafhandeling te verifiëren. Houd herhaalde events veilig en zorg dat een inactieve entitlement betaalde operaties blokkeert. Native mobiele aankopen blijven een aparte RevenueCat-integratiegrens.
Setup en configuratie
De plancatalogus leeft in src/product-plans.ts en stuurt het /billing-oppervlak en de /choose-plan-onboardingstap. Billing configureert zich server-side met BILLING_PROVIDER=stripe, STRIPE_SECRET_KEY, de price-ids per plan en interval, en STRIPE_WEBHOOK_SECRET. Lemon Squeezy is beschikbaar als alternatieve adapter.
Plannen op basis van seats gebruiken de bewerkbare seat-steppers (src/seat-count.ts); het aantal reist mee met de afrekensessie zodat de gefactureerde seats overeenkomen met de workspace. Plannen kunnen ook meteredUsage declareren in src/product-plans.ts zodat de uurlijkse taak billing.usage-report usage_counter-delta’s rapporteert aan Stripe-factureringsmeters, terwijl workspace-eigenaren maandelijkse AI-budgetten en harde plafonds per meter instellen onder Instellingen → Gebruik (USAGE_METERS in src/usage-meters.ts).
Checkout: POST /api/billing/checkout
Portal: POST /api/billing/portal
Webhook: POST /api/billing/webhook (signature-verified)Implementatieworkflow
Een checkout-redirect is slechts een openstaande intentie — toegang verandert wanneer het ondertekende webhook aankomt en de server-owned entitlement wordt bijgewerkt. Gate betaalde acties met de entitlement-check aan de servergrens (entitlement-gate.tsx / entitlement-check.ts), zelfs als de UI ze al verbergt.
De klantenportal beheert planwijzigingen, annulering en betaalmethoden. Houd de abonnementsstatus leesbaar voor workspace-leden en native mobiele aankopen achter de aparte RevenueCat-grens.