Verstehe Rivya-Plan- und Credit-Pack-Checkout, Stripe-Redirects, die /payment-Brücke, Webhooks, Billing-Updates und Kaufprüfungen.

Nutze diesen Payment-Checkout-Leitfaden, wenn du verstehen möchtest, was nach dem Kauf eines Plans oder Credit-Packs in Rivya passiert.

Was Menschen bei Zahlungen in Rivya meist missverstehen, ist:

Dass Stripe die Zahlung abschließt, ist nicht der letzte Schritt. Das Produkt muss noch aufholen und diese Änderung korrekt widerspiegeln.

Deshalb endet der Checkout-Flow nicht bei Stripe, und er endet auch nicht in dem Moment, in dem der Browser zurückkommt.

Der Zahlungsfluss hat drei echte Phasen

Aktuell ist Checkout leichter zu verstehen, wenn du ihn in drei Phasen zerlegst:

Rivya erstellt die Checkout-Session
der Nutzer schließt Stripe Checkout ab
Rivya wartet, bis der Produktstatus wieder vertrauenswürdig ist

Genau für diese dritte Phase existiert /payment.

Wo Checkout starten kann

Checkout startet aktuell an Stellen, die bereits zur Nutzerabsicht passen:

Pricing
/settings/billing
/settings/credits

Und die zwei wichtigsten Kaufarten sind:

Checkout für Abonnementpläne
Checkout für einmalige Credit-Packs

Das sind unterschiedliche kommerzielle Entscheidungen, aber sie laufen trotzdem in denselben Bestätigungspfad.

Plan-Checkout und Credit-Pack-Checkout sind ähnlich, aber nicht gleich

Plan-Checkout ist abonnementsförmig.

Credit-Pack-Checkout ist wie eine einmalige Wallet-Aufladung geformt.

Dieser Unterschied ist wichtig, weil Rivya nach der Zahlung wissen muss, ob es Folgendes aktualisieren soll:

Abonnementstatus
oder Wallet-Status

Deshalb kann derselbe Stripe-Erfolgsmoment dich danach trotzdem zu unterschiedlichen Produktoberflächen zurückschicken.

Warum `/payment` überhaupt existiert

/payment ist keine Receipt-Seite im üblichen Sinn.

Es ist eine Verarbeitungsbrücke.

Ihre Aufgabe ist:

die Stripe-session_id zu lesen
zu prüfen, ob der produktseitige Zahlungsdatensatz abgeschlossen ist
bei Bedarf für kurze Zeit weiter zu pollen
dich erst dann zurück in den richtigen Teil der App zu leiten

Damit ist sie eher eine Seite zur Statussynchronisierung als eine Inhaltsseite.

Wann ist eine Zahlung aus Produktsicht "wirklich fertig"?

Aus Nutzersicht fühlt sich eine Zahlung abgeschlossen an, sobald Stripe sagt, dass sie funktioniert hat.

Aus Produktsicht ist die Zahlung erst wirklich abgeschlossen, wenn der Account-Status in Rivya sichtbar aktualisiert wurde.

Das bedeutet normalerweise:

der Zahlungsdatensatz ist als paid oder completed markiert
Abonnement- oder Wallet-Effekte sind sichtbar
du kannst sicher zu Billing oder Credits zurückkehren, ohne veralteten Status zu sehen

Das ist der eigentliche Grund, warum das Produkt auf /payment wartet, statt den Nutzer sofort in die App zurückzuwerfen.

Warum Webhooks weiterhin wichtig sind, obwohl `/payment` pollt

/payment ersetzt Stripe-Webhooks nicht.

Webhooks aktualisieren weiterhin den dauerhaften Backend-Status.

Die Seite /payment existiert, damit die Erfahrung warten kann, bis dieser Status zuverlässig genug sichtbar ist, bevor weitergeleitet wird.

Das ist der Unterschied zwischen:

"Stripe hat etwas verarbeitet"
und "Rivya zeigt diese Änderung jetzt klar an"

Wohin du nach der Zahlung gehst

Der Rückkehrpfad ist bewusst an das gebunden, was sich geändert hat.

Wenn der Kauf ein Abonnement betraf, wirst du meist Richtung Billing zurückgeschickt.

Wenn der Kauf ein Credit-Pack war, wirst du meist Richtung Credits zurückgeschickt.

Das ist kein kosmetisches Routing. Es passt zu der Frage, die Nutzer direkt nach dem Bezahlen normalerweise haben:

Hat sich mein Plan aktualisiert?
oder hat sich meine Wallet aktualisiert?

Was Timeout oder Fehler wirklich bedeuten

Wenn /payment timeoutet oder fehlschlägt, bedeutet das nicht automatisch, dass die Zahlung selbst verschwunden ist.

Häufiger bedeutet es eines davon:

der produktseitige Zahlungsdatensatz ist noch nicht abgeschlossen
der Redirect wartet auf Status, der noch aufholt
die Account-Seite würde immer noch veraltet aussehen, wenn der Nutzer zu früh weitergeleitet würde

Deshalb ist ein Timeout-Status besser als ein falscher Erfolgsstatus. Er sagt dem Nutzer, dass die Produktbestätigung noch unvollständig ist.

Der beste Weg zu prüfen, ob die Zahlung wirklich angekommen ist

Nach Checkout ist der sauberste Prüfpfad:

/payment seinen Flow beenden lassen
/settings/billing prüfen, wenn der Kauf ein Plan war
/settings/credits prüfen, wenn der Kauf ein Pack war
Notifications Center prüfen, wenn der Account weiterhin nicht synchron wirkt

Das ist meist besser, als zufällige Seiten zu aktualisieren und zu raten.

Zahlung wird auch zu Account-Gedächtnis

Zahlung ist nicht nur eine Checkout-Aktion. Sie wird durch dauerhafte Ereignisse auch Teil der Account-History, zum Beispiel:

Abonnement gestartet
Abonnement erneuert
Zahlung fehlgeschlagen
Credit-Paket hinzugefügt

Deshalb sind Notifications hier ebenfalls wichtig. Das Schließen des Stripe-Tabs ist nicht das Ende der Account-Geschichte.

Ein besseres mentales Modell

Die einfachste Art, Rivya Checkout zu verstehen:

Stripe verarbeitet die Geldbewegung
/payment verarbeitet den produktseitigen Wiedereinstieg

Wenn du diese zwei Rollen trennst, wird der gesamte Flow leichter verständlich.

Checkliste zum Checkout-Status

Wenn ein Kauf unfertig oder verwirrend wirkt, prüfe:

Bestätige, wo Checkout gestartet wurde: öffentliches Pricing, Billing-Settings oder Credits-Settings.
Prüfe, ob Stripe die Zahlung abgeschlossen und den Nutzer zu /payment zurückgeführt hat.
Warte, bis Rivya Abonnement-, Pack-, Invoice- und Wallet-Status aktualisiert hat, bevor du eine weitere bezahlte Aufgabe startest.
Nutze Billing-Seiten für Abonnements und Credits-Seiten für Packs oder Wallet-History.
Behandle einen Browser-Redirect nicht als Beweis, dass Webhook und Account-Status bereits abgeschlossen sind.

Vor erneutem Zahlungsversuch prüfen

Prüfe vor einem erneuten Versuch, wenn der Nutzer einen veralteten Plan, fehlende Credits, doppelte Checkout-Fenster, eine fehlgeschlagene Zahlung oder eine erfolgreiche Stripe-Quittung sieht, die in Rivya noch nicht sichtbar ist.

Rivya Payment-Checkout-Leitfaden