Dokumentace Rivya AI

Průvodce platbou a dokončením nákupu v Rivya

Pochopte nákup tarifů a kreditových balíčků Rivya, přesměrování Stripe, most /payment, webhooky, aktualizace fakturace a kontroly nákupu.

Naposledy zkontrolováno 2026/04/28

Tento průvodce dokončením platby použijte, když potřebujete pochopit, co se stane po koupi tarifu nebo kreditového balíčku v Rivya.

U plateb v Rivya lidé obvykle špatně chápou toto:

To, že Stripe dokončí platbu, není poslední krok. Produkt ještě musí doběhnout a správně tuto změnu zobrazit.

Proto platební tok nekončí ve Stripe a nekončí ani ve chvíli, kdy se prohlížeč vrátí zpět.

Platební tok má tři skutečné fáze

Checkout je teď snazší pochopit, když ho rozdělíte do tří fází:

  1. Rivya vytvoří platební relaci
  2. uživatel dokončí Stripe Checkout
  3. Rivya čeká, až bude produktový stav znovu důvěryhodný

Právě kvůli třetí fázi existuje /payment.

Kde může platba začít

Checkout aktuálně začíná z míst, která už odpovídají záměru uživatele:

  • Pricing
  • /settings/billing
  • /settings/credits

A dva hlavní tvary nákupu jsou:

  • nákup předplatného tarifu
  • nákup jednorázového kreditového balíčku

Jsou to různá komerční rozhodnutí, ale stále se sbíhají do stejné potvrzovací cesty.

Checkout tarifu a kreditového balíčku jsou podobné, ale ne stejné

Checkout tarifu má tvar předplatného.

Checkout kreditového balíčku má tvar jednorázového dobití peněženky.

Na tomto rozdílu záleží, protože po platbě musí Rivya vědět, zda má obnovit:

  • stav předplatného
  • nebo stav peněženky

Proto vás stejný úspěšný okamžik ve Stripe může následně poslat zpět na různé produktové plochy.

Proč /payment vůbec existuje

/payment není stránka účtenky v běžném smyslu.

Je to zpracovací most.

Jeho úkolem je:

  • přečíst Stripe session_id
  • zkontrolovat, zda se produktový platební záznam usadil
  • v případě potřeby krátkou dobu dál pollovat
  • teprve potom vás přesměrovat zpět do správné části aplikace

Je tedy spíš stránkou synchronizace stavu než obsahovou stránkou.

Kdy je platba z pohledu produktu „opravdu hotová“?

Z pohledu uživatele platba působí hotově, jakmile Stripe řekne, že proběhla.

Z pohledu produktu je platba opravdu hotová až tehdy, když je stav účtu viditelně aktualizovaný v Rivya.

Obvykle to znamená:

  • platební záznam je označený jako paid nebo completed
  • dopady na předplatné nebo peněženku jsou viditelné
  • můžete se bezpečně vrátit do fakturace nebo kreditů, aniž byste viděli zastaralý stav

To je skutečný důvod, proč produkt čeká na /payment, místo aby uživatele okamžitě hodil zpět do aplikace.

Proč webhooky stále záleží, i když /payment polluje

/payment nenahrazuje Stripe webhooky.

Webhooky stále aktualizují trvalý backendový stav.

Stránka /payment existuje proto, aby uživatelská zkušenost počkala, dokud se tento stav nepromítne dost dobře na to, aby se mu dalo věřit, a až potom přesměrovala.

To je rozdíl mezi:

  • „Stripe něco zpracoval“
  • a „Rivya teď tuto změnu jasně odráží“

Kam jdete po platbě

Návratová cesta je záměrně navázaná na to, co se změnilo.

Pokud nákup souvisel s předplatným, obvykle jste posláni zpět k fakturaci.

Pokud byl nákup kreditový balíček, obvykle jste posláni zpět ke kreditům.

Není to kosmetické routování. Odpovídá otázce, kterou uživatelé obvykle mají hned po zaplacení:

  • aktualizoval se můj tarif?
  • nebo se aktualizovala moje peněženka?

Co ve skutečnosti znamená timeout nebo selhání

Pokud /payment vyprší nebo selže, neznamená to automaticky, že platba samotná zmizela.

Častěji to znamená jednu z těchto věcí:

  • produktový platební záznam se ještě neusadil
  • přesměrování čeká na stav, který ještě dobíhá
  • stránka účtu by pořád vypadala zastarale, kdyby byl uživatel přesměrován příliš brzy

Proto je stav timeoutu lepší než falešný úspěch. Říká uživateli, že nedokončená část je produktové potvrzení.

Nejlepší způsob, jak ověřit, že platba opravdu dopadla

Po dokončení nákupu je nejčistší ověřovací cesta:

  1. nechte /payment dokončit svůj tok
  2. pokud byl nákup tarif, zkontrolujte /settings/billing
  3. pokud byl nákup balíček, zkontrolujte /settings/credits
  4. pokud účet pořád vypadá nesynchronizovaně, zkontrolujte Průvodce Notifications Center v Rivya

To je obvykle lepší než náhodně obnovovat stránky a hádat.

Platba se také stává pamětí účtu

Platba není jen akce dokončení nákupu. Stává se také součástí historie účtu přes trvalé události, jako jsou:

  • předplatné začalo
  • předplatné bylo obnoveno
  • platba selhala
  • kreditový balíček byl přidán

Proto zde záleží i na oznámeních. Zavření karty Stripe není konec příběhu účtu.

Lepší mentální model

Nejjednodušší způsob, jak přemýšlet o platebním toku Rivya, je:

  • Stripe řeší pohyb peněz
  • /payment řeší návrat na produktové straně

Když tyto dvě role držíte odděleně, celý tok se snáz chápe.

Číst dál

Kontrolní seznam stavu platby

Když nákup vypadá nedokončeně nebo matoucím způsobem, zkontrolujte:

  • Potvrďte, kde Checkout začal: veřejný pricing, nastavení fakturace nebo nastavení kreditů.
  • Zkontrolujte, zda Stripe dokončil platbu a vrátil uživatele na /payment.
  • Před spuštěním další placené úlohy počkejte, až Rivya obnoví stav předplatného, balíčku, faktury a peněženky.
  • Stránky fakturace používejte pro předplatná a stránky kreditů pro balíčky nebo historii peněženky.
  • Neberte přesměrování prohlížeče jako důkaz, že webhook a stav účtu už jsou usazené.

Znovu zkontrolujte před opakováním platby

Znovu zkontrolujte situaci před opakováním platby, pokud uživatel vidí zastaralý tarif, chybějící kredity, duplicitní Checkout okna, selhanou platbu nebo úspěšnou účtenku Stripe, která se v Rivya zatím neprojevila.

Obsah