Zrozum checkout planów i pakietów kredytów w Rivya, przekierowania Stripe, most /payment, webhooks, aktualizacje billing i kontrole zakupu.

Użyj tego przewodnika po payment checkout, gdy musisz zrozumieć, co dzieje się po zakupie planu albo pakietu kredytów w Rivya.

To, co użytkownicy zwykle źle rozumieją w płatnościach Rivya, jest takie:

Zakończenie płatności przez Stripe nie jest ostatnim krokiem. Produkt nadal musi nadrobić i poprawnie odzwierciedlić tę zmianę.

Dlatego checkout flow nie kończy się na Stripe i nie kończy się w chwili, gdy przeglądarka wraca.

Flow Płatności Ma Trzy Prawdziwe Etapy

Obecnie checkout łatwiej zrozumieć, jeśli podzielisz go na trzy etapy:

Rivya tworzy sesję checkout
użytkownik kończy Stripe Checkout
Rivya czeka, aż stan produktu znów stanie się godny zaufania

Ten trzeci etap jest dokładnie powodem istnienia /payment.

Skąd Może Zacząć Się Checkout

Checkout obecnie zaczyna się z miejsc, które już pasują do intencji użytkownika:

Pricing
/settings/billing
/settings/credits

Dwa główne kształty zakupu to:

checkout planu subskrypcyjnego
jednorazowy checkout pakietu kredytów

To różne decyzje komercyjne, ale nadal zbiegają się w tej samej ścieżce potwierdzenia.

Checkout Planu I Checkout Pakietu Kredytów Są Podobne, Ale Nie Takie Same

Checkout planu ma kształt subskrypcji.

Checkout pakietu kredytów ma kształt jednorazowego doładowania portfela.

Ta różnica ma znaczenie, ponieważ po płatności Rivya musi wiedzieć, czy powinna odświeżyć:

stan subskrypcji
czy stan portfela

Dlatego ten sam moment sukcesu Stripe może potem odesłać cię do różnych powierzchni produktu.

Dlaczego `/payment` W Ogóle Istnieje

/payment nie jest stroną paragonu w zwykłym sensie.

To most przetwarzania.

Jego zadaniem jest:

odczytać Stripe session_id
sprawdzić, czy produktowy rekord płatności został rozliczony
w razie potrzeby pollować przez krótki czas
dopiero potem przekierować cię z powrotem do właściwej części aplikacji

To czyni go bardziej stroną synchronizacji stanu niż stroną treści.

Kiedy Płatność Jest „Naprawdę Gotowa” Z Perspektywy Produktu?

Z perspektywy użytkownika płatność wydaje się zakończona, gdy Stripe mówi, że zadziałała.

Z perspektywy produktu płatność jest naprawdę zakończona dopiero wtedy, gdy stan konta jest widocznie zaktualizowany w Rivya.

Zwykle oznacza to:

rekord płatności jest oznaczony jako paid albo completed
efekty subskrypcji albo portfela są widoczne
możesz bezpiecznie wrócić do billing albo credits bez oglądania nieświeżego stanu

To prawdziwy powód, dla którego produkt czeka na /payment, zamiast natychmiast wrzucać użytkownika z powrotem do aplikacji.

Dlaczego Webhooks Nadal Mają Znaczenie, Mimo Że `/payment` Polluje

/payment nie zastępuje Stripe webhooks.

Webhooks nadal aktualizują trwały stan backendu.

Strona /payment istnieje po to, aby doświadczenie mogło poczekać, aż ten stan będzie odzwierciedlony wystarczająco dobrze, by mu zaufać, zanim nastąpi przekierowanie.

To różnica między:

„Stripe coś przetworzył”
a „Rivya teraz jasno odzwierciedla tę zmianę”

Dokąd Trafiasz Po Płatności

Ścieżka powrotu jest celowo powiązana z tym, co się zmieniło.

Jeśli zakup dotyczył subskrypcji, zwykle trafiasz z powrotem w stronę billing.

Jeśli zakup dotyczył pakietu kredytów, zwykle trafiasz z powrotem w stronę credits.

To nie jest kosmetyczny routing. Pasuje do pytania, które użytkownicy zwykle mają zaraz po zapłacie:

czy mój plan się zaktualizował?
czy mój portfel się zaktualizował?

Co Naprawdę Oznacza Timeout Albo Awaria

Jeśli /payment przekroczy czas albo się nie powiedzie, to nie oznacza automatycznie, że sama płatność zniknęła.

Częściej oznacza jedną z tych rzeczy:

produktowy rekord płatności nie został jeszcze rozliczony
przekierowanie czeka na stan, który nadal nadrabia
strona konta nadal wyglądałaby na nieświeżą, gdyby użytkownik został przekierowany za wcześnie

Dlatego stan timeoutu jest lepszy niż fałszywy sukces. Mówi użytkownikowi, że potwierdzenie po stronie produktu nadal jest niepełne.

Najlepszy Sposób Sprawdzenia, Czy Płatność Naprawdę Dotarła

Po checkout najczystsza ścieżka weryfikacji to:

pozwól /payment dokończyć flow
sprawdź /settings/billing, jeśli zakup był planem
sprawdź /settings/credits, jeśli zakup był pakietem
sprawdź Przewodnik po Rivya Notifications Center, jeśli konto nadal wygląda na niespójne

To zwykle lepsze niż odświeżanie losowych stron i zgadywanie.

Płatność Też Staje Się Pamięcią Konta

Płatność nie jest tylko akcją checkout. Staje się też częścią historii konta przez trwałe zdarzenia, takie jak:

rozpoczęcie subskrypcji
odnowienie subskrypcji
nieudana płatność
dodanie pakietu kredytów

Dlatego notifications mają tu znaczenie. Zamknięcie karty Stripe nie kończy historii konta.

Lepszy Model Myślowy

Najprostszy sposób myślenia o checkout w Rivya jest taki:

Stripe obsługuje ruch pieniędzy
/payment obsługuje powrót po stronie produktu

Jeśli trzymasz te dwie role osobno, całe flow staje się łatwiejsze do zrozumienia.

Checklista Stanu Checkout

Gdy zakup wygląda na niedokończony albo mylący, sprawdź:

Potwierdź, skąd zaczął się Checkout: public pricing, billing settings czy credits settings.
Sprawdź, czy Stripe zakończył płatność i zwrócił użytkownika do /payment.
Poczekaj, aż Rivya odświeży stan subskrypcji, pakietu, invoice i portfela przed rozpoczęciem kolejnego płatnego zadania.
Używaj stron billing dla subskrypcji i stron credits dla pakietów albo historii portfela.
Nie traktuj przekierowania przeglądarki jako dowodu, że webhook i stan konta już się rozliczyły.

Sprawdź Ponownie Przed Ponowną Próbą Płatności

Sprawdź ponownie przed retry, jeśli użytkownik widzi nieświeży plan, brakujące kredyty, zdublowane okna Checkout, nieudaną płatność albo udany paragon Stripe, który nie jest jeszcze odzwierciedlony w Rivya.

Przewodnik po płatnościach i checkout w Rivya