Zum Inhalt springen
supastack
Dokumentation durchstöbern
WebNext.js

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 /de/docs/web/billing.md (or send Accept: text/markdown).

Zahlungen und Abonnements

Stripe-Checkout, Planverwaltung und die Entitlement-Grenze.

Zu dieser Anleitung fragen
Öffnen in

Wählen und testen Sie Ihren Zahlungsdienst

Billing wickelt Zahlungen ab. Zugriffsberechtigungen werden separat als Berechtigungen gespeichert. Schließen Sie die Einrichtung des dauerhaften Kontos ab und öffnen Sie dann /billing in der laufenden Web-App, um die Planoberfläche anzuzeigen. Mit BILLING_PROVIDER=local erkunden Sie lokales Verhalten, anstatt echtes Geld zu sammeln.

Wählen Sie einen unterstützten Zahlungsanbieter, folgen Sie dessen Einrichtungsanleitung, erstellen Sie Ihr eigenes Testprodukt und Ihren eigenen Preis und kopieren Sie die benannten Servereinstellungen in apps/web/.env.local.. Speichern Sie den Webserver und starten Sie ihn neu. Führen Sie einen Checkout mithilfe der Sandbox-Anweisungen dieses Anbieters durch und überprüfen Sie dann den Zugriffsstatus des Arbeitsbereichs, nachdem der Webhook des Anbieters eintrifft. Ein Webhook ist die signierte Nachricht des Anbieters an Ihren Server über ein Zahlungsereignis.

Eine Erfolgsseite allein schaltet keine Funktionen frei. Wenn der Checkout abgeschlossen ist, der Zugriff aber weiterhin inaktiv bleibt, überprüfen Sie die Webhook-Zustellung des Anbieters und die Ereignisverarbeitung Ihres Servers, bevor Sie die Zahlung wiederholen. Testabbruch und abgelaufener Zugang ebenfalls. Für Telefonkäufe wird die separate RevenueCat/Store-Einrichtung verwendet, nicht dieser Web-Checkout.

Web-Abrechnung

Die Webanwendung unterstützt den Abrechnungsanbieter, den Sie mit BILLING_PROVIDER auswählen; Streifen ist eine Option. Öffnen Sie /billing für Webpläne und Abonnementverwaltung. Befolgen Sie die Anleitung des ausgewählten Anbieters, um seine Nur-Server-Anmeldeinformationen, Produkt- oder Preis-IDs und Webhook-Überprüfungseinstellungen in der passenden Test- oder Live-Umgebung festzulegen.

Zugriff über Berechtigungen autorisieren

Eine Checkout-Weiterleitung belegt keinen aktiven Zugriff. Die serverseitig verwaltete Berechtigung entscheidet, ob ein Workspace eine kostenpflichtige Funktion nutzen kann. Prüfen Sie sie an der Aktionsgrenze, auch wenn die Oberfläche die Aktion bereits ausblendet.

Lifecycle überprüfen

Prüfen Sie Aktivierung, Änderungen, Kündigung und Webhook-Verarbeitung anhand von Sandbox-Ereignissen. Behandeln Sie wiederholte Ereignisse sicher und stellen Sie sicher, dass eine inaktive Berechtigung kostenpflichtige Vorgänge blockiert. Native Mobile-Käufe bleiben eine separate RevenueCat-Integrationsgrenze.

Einrichtung und Konfiguration

Der Plankatalog lebt in src/product-plans.ts und steuert die /billing-Oberfläche sowie den /choose-plan-Onboarding-Schritt. Billing wird serverseitig mit BILLING_PROVIDER=stripe, STRIPE_SECRET_KEY, den Price-IDs für jeden Plan und Intervall sowie STRIPE_WEBHOOK_SECRET konfiguriert. Lemon Squeezy ist als alternativer Adapter verfügbar.

Sitzplatzbasierte Pläne nutzen die editierbaren Sitzplatz-Stepper (src/seat-count.ts); die Anzahl wird mit der Checkout-Sitzung übermittelt, sodass die abgerechneten Sitzplätze dem Workspace entsprechen. Pläne können außerdem meteredUsage in src/product-plans.ts deklarieren, sodass der stündliche Job billing.usage-report usage_counter-Deltas an Stripe-Billing-Meter meldet, während Workspace-Inhaber unter Einstellungen → Nutzung (USAGE_METERS in src/usage-meters.ts) monatliche KI-Budgets und feste Obergrenzen pro Zähler festlegen.

Checkout: POST /api/billing/checkout
Portal:   POST /api/billing/portal
Webhook:  POST /api/billing/webhook  (signature-verified)

Implementierungsablauf

Ein Checkout-Redirect ist nur eine ausstehende Absicht — Zugang ändert sich, wenn der signierte Webhook ankommt und das serverseitige Entitlement aktualisiert. Gate bezahlte Aktionen mit der Entitlement-Prüfung an der Server-Grenze (entitlement-gate.tsx / entitlement-check.ts), auch wenn das Interface sie bereits verbirgt.

Das Kundenportal behandelt Planwechsel, Kündigung und Zahlungsmethoden. Halte den Abo-Status für Workspace-Mitglieder lesbar und native mobile Käufe hinter der separaten RevenueCat-Grenze.

Häufige Fragen

14 Fragen

Was ist supastack?

supastack ist eine modulare Basis zum Bauen von KI-gestützten SaaS-Produkten. Sie bündelt die gemeinsame Infrastruktur, damit du dich auf die Funktionen konzentrieren kannst, die dein Produkt ausmachen.

Unterstützt es Web und Mobil?

Ja. supastack enthält Next.js- und Expo-Apps als Ausgangspunkt für Web- und Mobile-Erlebnisse.

Welche Authentifizierung ist enthalten?

Better Auth deckt E-Mail/Passwort, OTP und Social Login ab. Persönliche Workspaces werden mit dem Konto provisioniert, damit Datensätze vom ersten Tag an begrenzt sind.

Wie wird KI unterstützt?

supastack enthält konfigurierbare Multi-Anbieter-KI, Nutzungsverfolgung, Budgets und verschlüsselte Bring-your-own-key-Unterstützung.

Wie werden Abonnements gehandhabt?

Für Produkte, die auf dem Kit aufbauen, bilden Stripe-Abrechnung, Abonnements und Berechtigungen die Basis für bezahlten Zugang. Anbieter-Geheimnisse bleiben serverseitig.

Wo liegt mein produktspezifischer Code?

Produktspezifische Funktionen bleiben in einem separaten Codebase, während das Produkt die Basismodule von supastack konfiguriert und integriert.

Wie funktioniert die Preisgestaltung von supastack?

Das Kit ist ein Einmalkauf mit lebenslangen Updates: Ein Framework für 249 $ (befristeter Einführungspreis — 100 $ Rabatt auf den regulären Preis von 349 $) oder Alle Frameworks (Next.js, iOS, Android) für 499 $ (befristeter Einführungspreis — 100 $ Rabatt auf den regulären Preis von 599 $), plus 75 $ pro zusätzlichem Entwickler-Sitz. Kein Kit-Abo. Checkout auf dieser Website liefert deinen Lizenzschlüssel per E-Mail, mit Repo-Zugang per GitHub-Einladung.

Wie begrenzen Workspaces meine Daten?

Nutzerdatensätze sind über workspaceId begrenzt. Identität, Berechtigungen, KI-Nutzung, Abrechnungsereignisse und Audit-Einträge bleiben innerhalb der persönlichen Workspace-Grenze.

Wie funktionieren Hintergrundjobs?

Trigger.dev ist die explizite Job-Laufzeit. Der JobRunner-Vertrag verspricht nur enqueue, status und cancel — Workflow-Semantik bleibt Trigger.dev-spezifisch und explizit.

Wie unterscheidet sich E-Mail von Outreach?

Transaktions-E-Mail deckt Produktabläufe wie Task-Abschluss-Hinweise ab. Cold Outreach und Kampagnen gehören zum Produkt selbst, außerhalb des E-Mail-Moduls dieses Kits.

Wie funktionieren mobile Käufe?

Mobile bietet native Käufe und Wiederherstellung über RevenueCat; dein Server prüft den Zugriff. Konfiguriere die Store-Konten und schließe Gerätetests vor der Veröffentlichung ab. Web-Abrechnung bleibt separat.

Wo liegen die KI-Anbieter-Schlüssel?

BYOK-Zugangsdaten sind verschlüsselt und bleiben serverseitig. Schlüssel werden in Logs bereinigt; Nutzung und Budgets bleiben auf Workspace-Ebene sichtbar.

Welche Zahlungsmethoden akzeptiert der Checkout?

Der von Stripe gehostete Checkout akzeptiert Karten und kann — sobald die Wallets im Stripe-Konto aktiviert sind — auch Alipay und WeChat Pay anbieten, praktisch für Käufer in China. Wallet-Autorisierungen werden asynchron bestätigt, sodass sich die Lizenzseite aktualisiert, sobald die Zahlung eingegangen ist.

Kann ich eine Rückerstattung erhalten?

Sobald du Zugriff auf das Repository hast, gehört supastack für immer dir und kann daher nicht zurückerstattet werden. Aber keine Sorge: Du erhältst den vollständigen Quellcode mit lebenslangen Updates, um unbegrenzt viele Produkte für dich oder deine Kunden zu erstellen und zu veröffentlichen. Du darfst den Code lediglich nicht weiterverkaufen oder das Repository als Starter-Kit oder Vorlage weitergeben.

DE
Design