Rivya AI dokumentáció

Útmutató a fizetéshez a Rivyában

Ismerd meg a Rivya előfizetéseinek és kreditcsomagjainak fizetési folyamatát, a Stripe-visszairányítást, a `/payment` oldal szerepét, a webhookokat, a számlázási frissítéseket és a vásárlás utáni ellenőrzést.

Utoljára ellenőrizve: 2026/04/28

Ezt az útmutatót akkor használd, amikor meg szeretnéd érteni, mi történik egy Rivya-előfizetés vagy kreditcsomag megvásárlása után.

A Rivya fizetésével kapcsolatban ezt szokták a legtöbben félreérteni:

Attól, hogy a Stripe befejezte a fizetést, még nem ez az utolsó lépés. A terméknek még utol kell érnie magát, és helyesen kell tükröznie a változást.

Ezért a fizetési folyamat nem a Stripe-nál ér véget, és nem is abban a pillanatban, amikor a böngésző visszatér.

A fizetési folyamatnak három valódi szakasza van

A folyamat könnyebben érthető, ha három szakaszra bontod:

  1. A Rivya létrehozza a fizetési munkamenetet

  2. a felhasználó befejezi a Stripe Checkout folyamatot

  3. a Rivya megvárja, amíg a termékállapot újra megbízhatóvá válik

Pont ezért létezik a /payment.

Honnan indulhat a fizetés

A fizetés olyan helyekről indul, amelyek már illeszkednek a felhasználó szándékához:

  • Árazás

  • /settings/billing

  • /settings/credits

A két fő vásárlási forma:

  • előfizetés vásárlása

  • egyszeri kreditcsomag vásárlása

Ezek különböző kereskedelmi döntések, de ugyanabba a megerősítési útvonalba futnak össze.

Az előfizetés és a kreditcsomag fizetése hasonló, de nem ugyanaz

A csomag fizetése előfizetést indít.

A kreditcsomag fizetése egyszeri egyenlegfeltöltés.

Ez a különbség azért számít, mert fizetés után a Rivyának tudnia kell, mit frissítsen:

  • az előfizetési állapotot

  • vagy a tárcaállapotot

Ezért ugyanaz a sikeres Stripe-esemény később a termék különböző területeire irányíthat vissza.

Miért létezik egyáltalán a /payment

A /payment nem hagyományos értelemben vett nyugtaoldal.

Feldolgozási híd.

Feladata:

  • beolvasni a Stripe session_id értékét

  • ellenőrizni, hogy a termékoldali fizetési rekord rendeződött-e

  • szükség esetén rövid ideig tovább ellenőrizni az állapotot

  • csak ezután visszairányítani a megfelelő alkalmazásrészbe

Ez inkább állapotszinkronizációs oldal, mint tartalmi oldal.

Mikor "kész" valóban egy fizetés a termék nézőpontjából?

A felhasználó szemszögéből a fizetés akkor tűnik késznek, amikor a Stripe azt mondja, hogy működött.

A termék szemszögéből a fizetés csak akkor valóban kész, amikor a fiókállapot láthatóan frissült a Rivyában.

Ez általában azt jelenti:

  • a fizetési rekord paid vagy completed jelölést kapott

  • az előfizetési vagy tárcahatások láthatók

  • biztonságosan vissza lehet térni a számlázási vagy kreditoldalra anélkül, hogy régi állapot jelenne meg

Ezért vár a termék a /payment oldalon ahelyett, hogy azonnal visszairányítaná a felhasználót az alkalmazásba.

Miért számítanak továbbra is a webhookok, ha a /payment ellenőrzi az állapotot?

A /payment nem váltja ki a Stripe webhookokat.

Továbbra is a webhookok frissítik a tartós szerveroldali állapotot.

A /payment oldal azért létezik, hogy az élmény meg tudja várni, amíg ez az állapot már elég megbízhatóan tükröződik a visszairányításhoz.

Ez a különbség:

  • "a Stripe feldolgozott valamit"

  • és "a Rivya most már egyértelműen tükrözi ezt a változást"

Hová kerülsz fizetés után

A visszatérési út szándékosan ahhoz kötődik, ami megváltozott.

Ha a vásárlás előfizetéshez kapcsolódott, általában a számlázás felé kerülsz vissza.

Ha kreditcsomagot vásároltál, általában a kreditek felé kerülsz vissza.

Ez nem kozmetikai útvonalkezelés. Ahhoz a kérdéshez igazodik, amelyet a felhasználók fizetés után általában feltesznek:

  • frissült a csomagom?

  • vagy frissült a tárcám?

Mit jelent valójában az időtúllépés vagy hiba

Ha a /payment időtúllépéssel vagy hibával zár, az nem jelenti automatikusan, hogy maga a fizetés eltűnt.

Gyakrabban valamelyik ezt jelenti:

  • a termékoldali fizetési rekord még nem rendeződött

  • a visszairányítás olyan állapotra vár, amely még utoléri magát

  • a fiókoldal még régi állapotot mutatna, ha túl korán irányítaná át a felhasználót

Ezért jobb egy időtúllépési állapot, mint egy hamis sikerállapot. Megmondja a felhasználónak, hogy a termékmegerősítés az a rész, amely még nincs kész.

A legjobb mód annak ellenőrzésére, hogy a fizetés valóban megérkezett-e

Fizetés után ez a legbiztosabb ellenőrzési út:

  1. hagyd, hogy a /payment befejezze a folyamatát

  2. ellenőrizd a /settings/billing oldalt, ha a vásárlás csomag volt

  3. ellenőrizd a /settings/credits oldalt, ha a vásárlás kreditcsomag volt

  4. nézd meg az Értesítési központot, ha a fiók még mindig szinkronon kívülinek tűnik

Ez általában jobb, mint véletlenszerű oldalakat frissítgetni és találgatni.

A fizetés fiókmemóriává is válik

A fizetés nem egyszeri művelet: tartós eseményeken keresztül a fiókelőzmények részévé is válik, például:

  • előfizetés indult

  • előfizetés megújult

  • fizetés sikertelen volt

  • kreditcsomag hozzáadva

Ezért számítanak itt is az értesítések. A Stripe fül bezárása nem a fióktörténet vége.

Jobb mentális modell

A Rivya fizetési folyamatának legegyszerűbb értelmezése:

  • a Stripe kezeli a pénzmozgást

  • a /payment kezeli a termékoldali visszalépést

Ha ezt a két szerepet külön tartod, az egész folyamat könnyebben érthetővé válik.

Olvasd tovább

A fizetési állapot ellenőrzőlistája

Amikor egy vásárlás befejezetlennek vagy zavarosnak tűnik, ellenőrizd:

  • Ellenőrizd, honnan indult a fizetés: a nyilvános árakról, a számlázási beállításokból vagy a kreditbeállításokból.

  • Ellenőrizd, hogy a Stripe befejezte-e a fizetést, és visszaküldte-e a felhasználót a /payment oldalra.

  • Várd meg, amíg a Rivya frissíti az előfizetés, a csomag, a számla és az egyenleg állapotát, mielőtt újabb fizetős feladatot indítasz.

  • Előfizetésekhez a számlázási oldalakat, csomagokhoz vagy tárcaelőzményekhez a kreditoldalakat használd.

  • Ne kezeld a böngészős visszairányítást bizonyítékként arra, hogy a webhook és a fiókállapot már rendeződött.

Ellenőrizd újra, mielőtt újrapróbálod a fizetést

Ellenőrizd újra, mielőtt ismét fizetnél, ha a felhasználó régi csomagot, hiányzó krediteket, több megnyitott Stripe Checkout ablakot, sikertelen fizetést vagy olyan sikeres Stripe-nyugtát lát, amely még nem tükröződik a Rivyában.