Complete (Hopefully) Guide to Stripe Subscription With An Actual Spec I Worked On
Zusammenfassung
Kurz
Der Autor beschreibt ein Stripe- und Supabase-Beispiel für Abos mit Probezeit, Tarifwechseln, Kündigungen und Zahlungsausfällen, wobei Webhooks die Datenbank aktuell halten und problematische Abos auf den kostenlosen Tarif zurückführen sollen. Einige Hilfsfunktionen sind ausgelassen, und der abschließende Webhook ist im Bericht nur als „todo“ angegeben.
Mittel
Der Bericht zeigt anhand einer konkreten Spezifikation, wie Stripe-Abos mit kostenlosem Tarif sowie Monats- und Jahresabo, 14-tägiger Probezeit, Kündigungen, Upgrades, Herabstufungen und Zahlungsausfällen verwaltet werden können. Der Autor beschreibt die Einrichtung mit Stripe und Supabase, empfiehlt Testuhren zur Simulation von Abrechnungszeiträumen und skizziert Tabellen für Preise und Nutzerberechtigungen.
Im Mittelpunkt stehen Webhooks, die den Status und Tarif in der Datenbank nachführen. Stripe soll bei wiederkehrenden Zahlungsausfällen zunächst erneut abbuchen; nach ausgeschöpften Versuchen oder einer Probezeit ohne Zahlungsmethode sieht das Beispiel eine Herabstufung auf den kostenlosen Tarif vor. Kündigungen und Herabstufungen werden zum Ende des Abrechnungszeitraums vorgemerkt, Upgrades sofort und anteilig berechnet. Verbleibende Probetage und die einmalige Nutzung einer Probezeit werden ebenfalls berücksichtigt.
Der Beitrag ist ein Beispiel für die dargestellte Konfiguration. Einige Hilfsfunktionen fehlen und werden an ein GitHub-Projekt ausgelagert; der als abschließend angekündigte Webhook steht im Text nur als „todo“. Die Anleitung ist damit nicht vollständig und ihre Aussagen sind nicht als unabhängig geprüfte allgemeine Stripe-Spezifikation zu verstehen.
Ausführlich lesen
Der Bericht beschreibt anhand einer konkreten Anforderung, wie eine Stripe-Abonnementverwaltung mit drei Tarifen umgesetzt werden kann: einem kostenlosen Tarif sowie Pro-Monats- und Pro-Jahresabos für 15 beziehungsweise 144 US-Dollar, jeweils mit 14 Tagen Probezeit. Zu den Vorgaben gehören eine einmalige Probezeit pro Nutzer, die Übertragung verbleibender Probetage beim Wechsel vom Monats- zum Jahrestarif, das Einziehen von Zahlungsdaten für kostenpflichtige Tarife samt Probezeit, Kündigungen und Herabstufungen zum Periodenende sowie sofortige, anteilig berechnete Upgrades. Scheitert eine wiederkehrende Zahlung, soll eine dreitägige Kulanzfrist gelten; nach erfolglosen Wiederholungsversuchen oder einer Probezeit ohne gültige Zahlungsmethode soll das Konto auf den kostenlosen Tarif wechseln.
Der Autor erläutert die Einrichtung mit Stripe und Supabase und veranschaulicht sie mit Datenbankschemata sowie TypeScript-Beispielen. Vorgesehen sind eine Produkttabelle für Preise und Tarifmerkmale sowie eine Berechtigungstabelle pro Nutzer, die unter anderem Stripe-Kunde, Abonnementstatus, Abrechnungszeitraum, Kündigungszeitpunkt, Folgetarif und Nutzung der Probezeit speichert. Für die Prüfung empfiehlt der Bericht Stripe-Testuhren, mit denen sich Zeitabläufe simulieren lassen. Die Stripe-Konfiguration umfasst ein Produkt mit drei Preisen und Einstellungen für Kundenportal, Kündigung, Up- und Downgrades sowie automatische Zahlungswiederholungen. Der Autor merkt an, dass seine anfängliche Aussage, die Preise müssten für verzögerte Herabstufungen zum selben Produkt gehören, laut eigener späterer Beobachtung nicht zwingend zutrifft.
Der zentrale technische Ansatz ist, eingehende Webhooks als maßgebliche Auslöser für die Aktualisierung der Nutzerberechtigungen zu behandeln. Bei Erstellung und Änderung eines Abonnements werden Tarif, Status, Abrechnungsdaten und Probezeit in der Datenbank nachgeführt. Der Artikel ordnet typische Fälle den Ereignissen zu: Eine erfolgreiche Probezeit und erfolgreiche wiederkehrende Zahlung führen zu Aktualisierungen; vorübergehende Zahlungsausfälle erscheinen als „past_due“, während Stripe weitere Versuche unternimmt. Nach ausgeschöpften Versuchen wird „unpaid“ als Anlass für die Herabstufung verwendet. Bei einer Probezeit ohne Zahlungsmethode empfiehlt der Autor den Stripe-Endzustand „pause“, damit das Ereignis „customer.subscription.paused“ eine gesonderte Behandlung auslösen kann. Die gezeigte Logik markiert die Rechnung als uneinbringlich, beendet das bisherige Abo und erstellt ein neues für den kostenlosen Tarif.
Eine vorgemerkte Kündigung bleibt laut Bericht zunächst aktiv und wird über ein Änderungsereignis gespeichert; erst die tatsächliche Beendigung löst das Löschen der Abonnementfelder aus. Bei Upgrades soll Stripe anteilige Beträge berechnen. Falls der neue Tarif eine Probezeit erlaubt, prüft der Beispielcode, ob sie bereits genutzt wurde oder ob aus einem bisherigen Testzeitraum noch Zeit übrig ist, und wendet gegebenenfalls eine Probezeit erneut an. Geplante Herabstufungen sollen über Stripe-Abonnementpläne automatisch zum Periodenende umgesetzt werden; die anschließende Tarifänderung werde wieder durch ein Änderungsereignis erfasst.
Die Reichweite des Berichts ist begrenzt: Er ist ein Implementierungsbeispiel für die beschriebene Konfiguration und verweist für ausgelassene Hilfsfunktionen auf ein GitHub-Projekt. Der angekündigte abschließende Webhook ist im Text lediglich mit „todo“ angegeben. Zudem nennt der Beitrag Unterschiede zwischen manueller und automatischer Zahlungseinziehung, führt aber vor allem den automatischen Ablauf aus. Die Aussagen und Codebeispiele sind daher als Darstellung des Autors zu verstehen, nicht als vollständige, unabhängig geprüfte Spezifikation für jede Stripe-Konfiguration.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Beide Zusammenfassungen von Luna wurden gemeinsam geprüft, da das Schema nur ein Ergebnis vorsieht; beide geben den Bericht im Kern treu wieder. Alle vier Fragen betreffen KI-Sicherheitsthemen, die im Stripe-Bericht nicht vorkommen, weshalb jeweils 0 vergeben wurde. Lunas Stufen 5, 1 und 0 wurden daher nicht übernommen.
Im Bericht, aber nicht in der Zusammenfassung
- Die dreitägige Kulanzfrist (Grace Period) bei fehlgeschlagener Zahlung im Pro-Tarif vor der Herabstufung auf Free wird in keiner der beiden Zusammenfassungen genannt
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Tempo und Grenzen
- SF-T1 Welche messbaren Schwellen sollen eine Pause auslösen, und wer prüft sie?
- clef 100 %kein Bezug
- Luna 41 %umfangreiche Belege
- JEV 43 %beantwortet teilweise oder widerspricht
- amos 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung kein Bezug
- SF-T1-T06 Welcher öffentliche Beleg zeigt, ob vereinbarte Grenzen eingehalten werden?