Stripe

Stripe verbinden, um Einmalzahlungen, Abonnements, Upgrades und Downgrades anzubieten und den Funktionszugriff anhand des tatsächlichen Abonnementstatus zu steuern.

Mit Stripe kannst du in Anwendungen, die du mit condoo.Vibe erstellst, Zahlungen annehmen und die Abrechnung verwalten.

Mit Stripe lassen sich folgende Funktionen entwickeln:

• Einmalzahlungen
• Wiederkehrende Abonnements
• SaaS-Tarife
• Zahlungsoberflächen
• Upgrades und Downgrades
• Abrechnungsverwaltung für Kunden
• Zahlungsabhängiger Zugriff auf Funktionen

Sobald Stripe verbunden ist, kannst du den gewünschten Zahlungsablauf beschreiben und condoo.Vibe die dazugehörige Anwendungslogik erstellen lassen.

Stripe verbinden. Dein Abrechnungsmodell beschreiben. condoo.Vibe den Zahlungsablauf erstellen lassen.

Was du mit Stripe entwickeln kannst

Stripe kann viele unterschiedliche Zahlungsabläufe ermöglichen.

Einmalige Käufe

Zum Beispiel:

Diesen Kurs für $99 verkaufen. Kunden sollen nach erfolgreicher Zahlung Zugang zum Kurs erhalten.

Abonnements

Zum Beispiel:

Die Tarife Starter, Pro und Business für $0, $29 und $99 pro Monat erstellen.

Kostenpflichtige Buchungen

Zum Beispiel:

Kunden müssen eine Beratungsgebühr von $50 bezahlen, bevor ihr Termin bestätigt wird.

Funktionszugriff

Zum Beispiel:

Die Analytics-Funktion soll nur Kunden mit einem aktiven Pro- oder Business-Abonnement zur Verfügung stehen.

Abrechnungsverwaltung

Zum Beispiel:

Eine Billing-Seite hinzufügen, auf der Kunden ihren aktuellen Tarif sehen und ihr Abonnement verwalten können.

condoo.Vibe kann diese Funktionen rund um deine Stripe-Verbindung erstellen.

Vor dem Start

Du benötigst ein Stripe-Konto, bevor du Stripe mit deiner Anwendung verbindest.

Außerdem benötigst du die passenden Stripe-Zugangsdaten für die verwendete Umgebung.

Stripe bietet getrennte Umgebungen für Tests und echte Zahlungen.

Stripe mit condoo.Vibe verbinden

Öffne dein condoo.Vibe-Projekt und wechsle zum Bereich Connectors.

Suche Stripe und wähle es aus.

Folge dem Verbindungsablauf und gib die von condoo.Vibe angeforderten Stripe-Zugangsdaten an.

Sobald die Verbindung konfiguriert ist, steht Stripe der Anwendung zur Verfügung, die du entwickelst.

Test Mode und Live Mode

Stripe stellt getrennte Umgebungen für Entwicklung und Produktion bereit.

Test Mode

Verwende diesen Modus während der Entwicklung.

Transaktionen belasten keine echten Karten. Dadurch kannst du Folgendes testen:

• Erfolgreiche Zahlungen
• Fehlgeschlagene Zahlungen
• Checkout
• Abonnements
• Abrechnungsabläufe
• Webhooks
• Anwendungsverhalten nach einer Zahlung

Live Mode

Verwende diesen Modus, sobald du echte Kundenzahlungen annehmen möchtest.

Ein empfohlener Ablauf ist:

Stripe Test Mode
      ↓
Mit condoo.Vibe verbinden
      ↓
Zahlungsablauf entwickeln
      ↓
Gesamten Ablauf testen
      ↓
Probleme beheben
      ↓
Live Mode konfigurieren
      ↓
Konfiguration testen
      ↓
Veröffentlichen

Verwende echte Kundenzahlungen nicht als ersten Test eines neuen Abrechnungssystems.

Den ersten Zahlungsablauf erstellen

Sobald Stripe verbunden ist, teile condoo.Vibe mit, was Kunden kaufen können sollen.

Zum Beispiel:

Für den vollständigen Marketingkurs eine Einmalzahlung von $29 hinzufügen. Kunden sollen auf Buy Now klicken, über Stripe bezahlen und nach erfolgreicher Zahlung Zugang zum Kurs-Dashboard erhalten.

condoo.Vibe kann den Ablauf anhand dieser Anforderung erstellen.

Vereinfacht dargestellt:

Kunde
   ↓
Buy Now
   ↓
Stripe Checkout
   ↓
Zahlung
   ↓
Zahlung prüfen
   ↓
Kauf erfassen
   ↓
Zugang gewähren
   ↓
Kurs-Dashboard

Es reicht nicht aus, den Kunden lediglich zu Stripe weiterzuleiten.

Deine Anwendung muss auch wissen, was nach der Zahlung geschehen soll.

Abonnements erstellen

Stripe ist besonders nützlich für SaaS-Anwendungen mit wiederkehrender Abrechnung.

Angenommen, du hast folgende Tarife:

Starter
$19/Monat

Pro
$49/Monat

Business
$99/Monat

Du könntest condoo.Vibe mitteilen:

Monatliche Abonnements für Starter zu $19, Pro zu $49 und Business zu $99 hinzufügen. Nutzer sollen ihren Tarif auf der Preisseite auswählen und über Stripe bezahlen. Nach erfolgreicher Zahlung ihr Konto mit dem richtigen Abonnement aktualisieren.

Damit definierst du sowohl die Zahlung als auch das Anwendungsverhalten.

Festlegen, was jeder Tarif enthält

condoo.Vibe muss nicht nur die Preise kennen.

Teile condoo.Vibe mit, was jedes Abonnement freischaltet.

Zum Beispiel:

Starter-Nutzer können bis zu 3 Projekte erstellen. Pro-Nutzer können bis zu 20 Projekte erstellen und auf Analysen zugreifen. Business-Nutzer erhalten unbegrenzte Projekte, Analysen und Teamzusammenarbeit.

Deine Anwendung kann dann anhand des Kundenabonnements bestimmen, welche Funktionen verfügbar sind.

Vereinfacht dargestellt:

Stripe-Abonnement
       ↓
Anwendung
       ↓
Aktueller Tarif
       ↓
Funktionsberechtigungen

Erfolgreiche Zahlung

Definiere das Zahlungsverhalten nicht nur für den Checkout.

Teile condoo.Vibe mit, was geschehen soll, nachdem Stripe eine erfolgreiche Zahlung bestätigt hat.

Zum Beispiel:

Nach erfolgreicher Zahlung den Kauf erfassen, das Kundenabonnement aktualisieren, Pro-Funktionen freischalten und den Kunden zum Dashboard weiterleiten.

So entsteht ein vollständiger Zahlungsablauf.

Fehlgeschlagene Zahlung

Zahlungen können fehlschlagen.

Deine Anwendung sollte damit richtig umgehen.

Zum Beispiel:

Wenn die Zahlung fehlschlägt, das Abonnement nicht aktivieren. Dem Kunden anzeigen, dass die Zahlung erfolglos war, und einen erneuten Versuch ermöglichen.

Vereinfacht dargestellt:

Zahlungsversuch
      ↓
   Erfolgreich?
    ↙       ↘
   Ja       Nein
   ↓          ↓
Tarif        Bisherigen
aktivieren   Zugang behalten
   ↓          ↓
Dashboard    Erneut versuchen

Nicht allein auf die Erfolgsseite vertrauen

Wenn ein Kunde:

/payment-success

aufruft, beweist das nicht zwangsläufig, dass die Zahlung erfolgreich abgeschlossen wurde.

Wichtige Zahlungsereignisse sollten durch den passenden serverseitigen Stripe-Ablauf geprüft werden.

Deine Anwendung sollte bestätigte Zahlungsinformationen verwenden, bevor sie kostenpflichtige Funktionen aktiviert.

Stripe-Webhooks

Stripe kann deine Anwendung über wichtige Abrechnungsereignisse benachrichtigen.

Diese Benachrichtigungen werden üblicherweise Webhooks genannt.

Zum Beispiel:

Kunde
   ↓
Stripe Checkout
   ↓
Zahlung erfolgreich
   ↓
Stripe sendet Ereignis
   ↓
condoo.Vibe-Anwendung
   ↓
Abonnement aktualisiert

Webhooks sind für Abonnements besonders wichtig, weil Abrechnungsereignisse auch dann auftreten können, wenn der Kunde deine Anwendung gerade nicht nutzt.

Abonnementereignisse treten auch später auf

Stell dir vor, jemand schließt heute ein Abonnement ab.

Dreißig Tage später versucht Stripe, das Abonnement zu verlängern.

Der Kunde hat deine Anwendung möglicherweise gar nicht geöffnet.

Deine Anwendung muss trotzdem wissen, ob:

• Die Verlängerung erfolgreich war
• Die Verlängerung fehlgeschlagen ist
• Das Abonnement geändert wurde
• Das Abonnement gekündigt wurde

Stripe kann diese Ereignisse an deine Anwendung senden.

Deine Anwendung kann ihren eigenen Abonnementstatus dann entsprechend aktualisieren.

Stripe und deine Datenbank synchron halten

Deine Anwendung speichert möglicherweise Informationen wie:

Nutzer
Tarif: Pro
Abonnementstatus: Aktiv
Stripe-Kunden-ID: ...
Stripe-Abonnement-ID: ...

Stripe bleibt für die Zahlungsabwicklung zuständig.

Deine Anwendung verwendet relevante Abrechnungsinformationen, um festzulegen, welche Funktionen der Kunde erhält.

Vereinfacht dargestellt:

STRIPE
Zahlungs- und Abonnementstatus
        ↓
SERVERSEITIGE LOGIK
        ↓
NEON POSTGRES
Abonnementstatus der Anwendung
        ↓
DEIN PRODUKT
Funktionen und Zugriff

Diese Systeme synchron zu halten ist ein wichtiger Bestandteil zuverlässiger Abonnementsoftware.

Upgrades

Angenommen, ein Starter-Kunde möchte zu Pro wechseln.

Du könntest condoo.Vibe mitteilen:

Starter-Kunden sollen über die Billing-Seite auf Pro upgraden können. Nachdem Stripe die Abonnementänderung bestätigt hat, ihr Konto aktualisieren und die Pro-Funktionen freischalten.

Deine Anwendung sollte den neuen Tarif anzeigen, sobald die Abrechnungsänderung erfolgreich ist.

Downgrades

Downgrades können weitere Produktentscheidungen erfordern.

Angenommen:

• Starter: 3 Projekte
• Pro: 20 Projekte

Ein Pro-Kunde hat derzeit 12 Projekte und wechselt zu Starter.

Was passiert?

Das musst du entscheiden.

Zum Beispiel:

Wenn ein Nutzer zu einem Tarif wechselt, dessen Projektlimit unter seiner aktuellen Nutzung liegt, bestehende Projekte nicht löschen. Das Erstellen weiterer Projekte verhindern, bis die Nutzung innerhalb des neuen Tariflimits liegt.

Das ist eine Produktregel.

Stripe verwaltet die Abrechnungsänderung.

condoo.Vibe erstellt das dazugehörige Verhalten deiner Anwendung.

Kündigungen

Du solltest auch festlegen, was eine Kündigung bedeutet.

Zum Beispiel:

Wenn Kunden kündigen, ihren Pro-Zugang bis zum Ende des aktuellen Abrechnungszeitraums beibehalten. Nach Ablauf des Abonnements zu Starter wechseln.

Oder:

Dieses Produkt hat keinen kostenlosen Tarif. Nach Ende des bezahlten Abrechnungszeitraums das Konto beibehalten, aber den Zugriff einschränken, bis der Kunde erneut ein Abonnement abschließt.

Es gibt kein einziges richtiges Kündigungsmodell.

Teile condoo.Vibe mit, wie dein Produkt reagieren soll.

Abrechnungsverwaltung für Kunden

Bei Abonnementprodukten brauchen Kunden häufig einen Bereich zur Verwaltung ihrer Abrechnung.

Du kannst condoo.Vibe bitten:

Account Settings um einen Billing-Bereich ergänzen. Den aktuellen Tarif und Abonnementstatus des Kunden anzeigen und eine Möglichkeit zur Verwaltung des Abonnements anbieten.

Je nach deiner Stripe-Implementierung können Kunden die Abrechnungsverwaltung von Stripe nutzen, um beispielsweise ihr Abonnement oder ihre Zahlungsdaten zu verwalten.

Zugriff auf kostenpflichtige Funktionen beschränken

Deine Anwendung sollte den Zugriff auf kostenpflichtige Funktionen anhand des tatsächlichen Abonnementstatus durchsetzen.

Zum Beispiel:

Analytics
   ↓
Aktives Pro oder Business?
     ↙          ↘
    Ja          Nein
    ↓             ↓
Analysen        Upgrade
anzeigen        anbieten

Du könntest condoo.Vibe mitteilen:

Analytics soll nur Pro- und Business-Kunden zur Verfügung stehen. Starter-Nutzer sollen stattdessen eine Upgrade-Seite sehen.

Wichtige Regeln für kostenpflichtigen Zugriff sollten angemessen durchgesetzt werden und sich nicht nur auf ausgeblendete Navigationslinks verlassen.

Beispiel: SaaS-Abonnement

Hier ist ein ausführlicherer Prompt:

Dieser SaaS-Anwendung Stripe-Abonnements hinzufügen.

Drei monatliche Tarife erstellen:

Starter: $19/Monat: 3 Projekte

Pro: $49/Monat: 20 Projekte + Analysen

Business: $99/Monat: unbegrenzte Projekte + Analysen + Teamzusammenarbeit

Nutzer sollen auf der Preisseite einen Tarif auswählen und den Checkout über Stripe abschließen.

Nachdem Stripe die Zahlung bestätigt hat, das Nutzerabonnement aktualisieren und die passenden Funktionen freischalten.

Eine Billing-Seite mit dem aktuellen Tarif und Abonnementstatus hinzufügen.

Kunden sollen ihr Abonnement verwalten können.

Wenn ein Abonnement abläuft, Funktionen entsprechend dem neuen Kontostatus einschränken.

Bei einer so wichtigen Funktion empfehle ich:

Plan + Max → Prüfen → Build

anstatt condoo.Vibe sofort mit der gesamten Umsetzung zu beauftragen.

Beispiel: Kostenpflichtige Buchung

Stripe eignet sich nicht nur für SaaS.

Angenommen, du entwickelst eine Beratungsplattform.

Kunden sollen einen verfügbaren Termin auswählen, ihre Angaben eingeben und eine Beratungsgebühr von $100 über Stripe bezahlen. Erst nach erfolgreicher Zahlung eine bestätigte Buchung erstellen. Dem Kunden anschließend eine Bestätigungs-E-Mail senden.

Vereinfacht dargestellt:

Termin auswählen
       ↓
Kundendaten
       ↓
Stripe-Zahlung
       ↓
Zahlung bestätigt
       ↓
Buchung bestätigen
       ↓
In Neon speichern
       ↓
Bestätigung senden

Das verbindet Stripe mit deiner Datenbank und E-Mail-Integration.

Beispiel: Einmaliger Kauf eines digitalen Produkts

Du könntest auch Folgendes entwickeln:

Diesen Bericht für $49 verkaufen. Kunden sollen über Stripe bezahlen und nach Prüfung der Zahlung in ihrem Konto Zugang zum Bericht erhalten.

Deine Anwendung kann den Kauf erfassen, damit der Kunde nicht bei jedem erneuten Besuch bezahlen muss.

Den Zahlungsablauf testen

Teste vor dem Annehmen echter Zahlungen den gesamten Kundenablauf.

Prüfe nicht nur, ob sich Stripe Checkout öffnet.

Teste:

Checkout

Kann der Kunde Stripe erreichen?

Erfolgreiche Zahlung

Erkennt die Anwendung die Zahlung?

Anwendungszustand

Wird der Tarif oder Kauf des Nutzers aktualisiert?

Funktionszugriff

Werden die richtigen Funktionen freigeschaltet?

Neuladen

Bleibt der richtige Zugriff nach dem Neuladen oder erneuten Anmelden erhalten?

Fehler

Was passiert, wenn die Zahlung fehlschlägt?

Kündigung

Reagiert deine Anwendung richtig?

Verlängerung

Verarbeitet die Anwendung bei Abonnements die Abrechnungsereignisse korrekt?

Berechtigungen

Können Nutzer auf Funktionen zugreifen, für die sie nicht bezahlt haben?

Zahlungstests sollten den gesamten Ablauf abdecken, nicht nur den Zahlungsbildschirm.

Häufige Probleme

Checkout öffnet sich nicht

Prüfe, ob Stripe korrekt verbunden ist und ob die Anwendung die Checkout-Sitzung erfolgreich erstellt.

Verwende den Debug-Modus und gib alle erhaltenen Fehlermeldungen an.

Zahlung erfolgreich, aber Tarif unverändert

Das bedeutet normalerweise, dass die Zahlung selbst und der Abonnementstatus deiner Anwendung getrennt untersucht werden müssen.

Teile condoo.Vibe mit:

Die Stripe-Zahlung ist erfolgreich, aber der Tarif des Nutzers bleibt anschließend Starter. Den Ablauf für Zahlungsbestätigung und Abonnementaktualisierung untersuchen. Die Checkout-Oberfläche nicht ändern.

Tarif wird erst nach dem Neuladen aktualisiert

Teile condoo.Vibe mit:

Stripe aktualisiert das Abonnement erfolgreich, aber das Dashboard zeigt bis zum Neuladen der Seite weiterhin den vorherigen Tarif. Den Anwendungszustand so korrigieren, dass das aktualisierte Abonnement nach der Zahlung erscheint.

Nutzer können ohne Zahlung auf kostenpflichtige Funktionen zugreifen

Das ist ein ernsteres Problem.

Teile condoo.Vibe mit:

Nutzer ohne aktives Pro-Abonnement können direkt auf die Analytics-Funktion zugreifen. Die Autorisierung der Pro-Funktionen prüfen und sicherstellen, dass der kostenpflichtige Zugriff serverseitig angemessen durchgesetzt wird.

Testzahlungen funktionieren, echte Zahlungen nicht

Prüfe, ob du von der richtigen Stripe-Testkonfiguration zur passenden Live-Konfiguration gewechselt bist.

Test- und Live-Zugangsdaten unterscheiden sich.

Prüfe außerdem, ob die von deiner Anwendung benötigte Webhook-Konfiguration für die Produktion korrekt eingerichtet ist.

Stripe-Fehler untersuchen

Wenn etwas nicht funktioniert, verwende den Debug-Modus.

Eine gute Anfrage zur Fehlersuche sieht so aus:

Stripe Checkout wird erfolgreich abgeschlossen.

Erwartet: Der Nutzer soll unmittelbar nach der Zahlung auf Pro hochgestuft werden.

Tatsächlich: Die Zahlung ist erfolgreich, aber das Nutzerkonto bleibt bei Starter.

Die Stripe-Transaktion wird als erfolgreich angezeigt.

Den gesamten Ablauf für Zahlungsbestätigung und Abonnementaktualisierung untersuchen. Die Ursache ermitteln und beheben, ohne die bestehende Preis- oder Checkout-Oberfläche zu ändern.

Gib condoo.Vibe folgende Informationen:

• Was passieren soll
• Was tatsächlich passiert
• Welche Fehler du siehst
• Welcher Teil bereits funktioniert

Das hilft condoo.Vibe, das Problem einzugrenzen.

Stripe-Zugangsdaten sicher aufbewahren

Geheime Stripe-Zugangsdaten sollten niemals bewusst im Frontend deiner Anwendung offengelegt werden.

Wenn du vermutest, dass Live-Zugangsdaten von Stripe offengelegt wurden, ersetze oder widerrufe sie in Stripe und aktualisiere die Konfiguration deiner Anwendung.

Über die Zahlungsschaltfläche hinausdenken

Stripe hinzuzufügen bedeutet nicht einfach:

Hier eine Zahlungsschaltfläche einfügen.

Berücksichtige den gesamten Lebenszyklus:

TARIF
 ↓
CHECKOUT
 ↓
ZAHLUNG
 ↓
PRÜFUNG
 ↓
ABONNEMENT / KAUF
 ↓
FUNKTIONSZUGRIFF
 ↓
VERLÄNGERUNG
 ↓
UPGRADE / DOWNGRADE
 ↓
KÜNDIGUNG

Bei einfachen einmaligen Käufen kann der Ablauf deutlich kleiner sein.

Bei SaaS-Produkten mit Abonnements wird die Abrechnung Teil der Produktarchitektur.

condoo.Vibe kann diese Architektur mit dir entwickeln, wenn du klar beschreibst, wie dein Geschäftsmodell funktionieren soll.

Als Nächstes: Resend

Stripe kümmert sich um Geld.

Als Nächstes verbinden wir deine Anwendung mit Resend, damit sie über Transaktions-E-Mails mit Nutzern kommunizieren kann.

Wir behandeln Abläufe wie:

• Begrüßungs-E-Mails
• Buchungsbestätigungen
• Bestellbestätigungen
• Kontaktbenachrichtigungen
• Teameinladungen
• Von der Anwendung ausgelöste E-Mails