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/modules/billing-configuration.md (or send Accept: text/markdown).
Stripe-configuratie en webhooks
Verbind webabonnementen met server-owned entitlements.
Setup en configuratie
Lees vóór elke stap Voordat u begint en Basisbeginselen van de terminal. Deze instructies gaan ervan uit dat je de volledige supastack monorepo in VS Code hebt geopend; zijn root package.json markeert de root van de repository. In pnpm-opdrachten is een werkruimtepakket een app of map met gedeelde code; in het product is een werkruimte de gegevenscontainer en de beveiligingsgrens van een team. corepack pnpm --filter ... selecteert één pakket uit de monorepo terwijl opdrachten vanuit de root worden uitgevoerd. Als u alleen een gesynchroniseerde mobiele map of desktopmap hebt geopend, bevat deze niet de webbackend, Docker-installatie of rootscripts: voer de backend uit vanaf deze monorepo of een bereikbare gehoste server en gebruik de eigen scripts van de platformmap. Een omgevingsvariabele is een benoemde instelling die is opgeslagen in een lokaal .env-bestand of op uw hostingdashboard; start de relevante app opnieuw nadat u deze hebt gewijzigd en houd servergeheimen buiten de NEXT_PUBLIC_- en EXPO_PUBLIC_-waarden.
1. Open apps/web/.env.local en bewaar BILLING_PROVIDER=local terwijl u het afrekenscherm leert.
2. Voor een echte integratie maakt u testmodusproducten in één provider en voegt u vervolgens de serversleutels en het webhookgeheim toe aan de instellingen van de privéomgeving van de webhost. Een webhook is een ondertekend bericht dat de factureringsservice naar uw app stuurt na het afrekenen, verlengen of annuleren; het eindpuntpad wordt vermeld in het codevoorbeeld van deze handleiding.
3. Start Web met corepack pnpm --filter @supastack/web dev en test alleen de sandbox. Verwacht: een geverifieerde webhook werkt de rechten van de aangemelde werkruimte bij; Alleen het openen van een afrekenpagina geeft geen toegang.
Gebruik sandbox-/testreferenties tijdens de integratie. Configureer BILLING_PROVIDER plus de servergeheimen van de provider: stripe → STRIPE_SECRET_KEY, STRIPE_PRICE_ID, STRIPE_WEBHOOK_SECRET; citroensqueezy → LEMONSQUEEZY_API_KEY, LEMONSQUEEZY_STORE_ID, LEMONSQUEEZY_VARIANT_ID, LEMONSQUEEZY_WEBHOOK_SECRET; creem → CREEM_API_KEY, CREEM_PRODUCT_ID, CREEM_WEBHOOK_SECRET (CREEM_TEST_MODE=true voor de sandbox); polair → POLAR_ACCESS_TOKEN, POLAR_PRODUCT_ID, POLAR_WEBHOOK_SECRET (POLAR_SERVER); whop → WHOP_API_KEY, WHOP_PLAN_ID, WHOP_WEBHOOK_SECRET; peddel → PADDLE_API_KEY, PADDLE_PRICE_ID, PADDLE_WEBHOOK_SECRET (PADDLE_ENVIRONMENT); dodo → DODO_PAYMENTS_API_KEY, DODO_PRODUCT_ID, DODO_PAYMENTS_WEBHOOK_KEY (DODO_PAYMENTS_ENVIRONMENT); PayPal → PAYPAL_CLIENT_ID, PAYPAL_CLIENT_SECRET, PAYPAL_PLAN_ID, PAYPAL_WEBHOOK_ID (PAYPAL_ENVIRONMENT). De prijs/product moet het beoogde terugkerende abonnement vertegenwoordigen.
Webhook endpoint: /api/billing/webhook (stripe), /api/billing/webhook/lemonsqueezy, /api/billing/webhook/creem, /api/billing/webhook/polar, /api/billing/webhook/whop, /api/billing/webhook/paddle, /api/billing/webhook/dodo, /api/billing/webhook/paypal
Checkout endpoint: /api/billing/checkout
Portal endpoint: /api/billing/portalCommando's om te kopiëren
Volg de opmerkingen om te zien in welke map een opdracht wordt uitgevoerd. Als twee terminals zijn gelabeld, opent u twee terminalvensters en laat u de eerste opdracht draaien terwijl u de tweede gebruikt.
corepack pnpm --filter @supastack/web devImplementatieworkflow
Volg de lifecycle-eventlijst in docs/real-provider-smoke.md bij het configureren van het webhookendpoint. Handtekeningverificatie vereist het bij het endpoint passende webhooksecret. Een checkoutredirect alleen mag nooit toegang verlenen.
De entitlement op de serveractiegrens beslist of betaald werk is toegestaan. Verwerk herhaalde events veilig en baken klant-/abonnementsrecords af op de juiste workspace. Webcheckout blijft gescheiden van native aankopen.
De sleutel die een plan verleent, is de productvocabulaire die over verschillende oppervlakken wordt gedeeld: ProductPlan.entitlement in src/product-plans.ts declareert de machinesleutel in kleine letters die in het grootboek is geschreven terwijl een plan wordt betaald (de kit verzendt 'ai.reference-task' op pro en lifetime; src/billing-runtime.ts geeft deze door aan de BFF). Dezelfde sleutel is waar het veld require_entitlement van een CMS-item en de entitlementKey prop equity-vergelijking van de EntitlementGate-component mee vergelijken: een item dat is afgesloten op 'ai.reference-task' wordt ontgrendeld voor elke werkruimte die die subsidie bevat, terwijl een sleutel die geen plan verleent voor iedereen vergrendeld blijft.
Verificatie en probleemoplossing
Als een webhook wordt afgewezen, vergelijk dan de exacte sandbox URL en het ondertekeningsgeheim in het providerdashboard met de serverinstellingen en controleer of die provider vereist dat verzoeken worden doorgestuurd naar localhost. Als het afrekenen werkt maar de toegang vergrendeld blijft, inspecteer dan het webhookresultaat en de toegangssleutel in het abonnement. Test nooit met live betalingsgegevens terwijl u deze lokale gids volgt.
Test activatie, updates, annulering, ongeldige handtekeningen en herhaalde events in de sandbox. Inspecteer de gepersisteerde toegangsstatus na verwerking. Een ongeconsumeerde checkoutsessie creëren bewijst alleen connectiviteit, geen lifecyclefulfilment.