Értsd meg a Rivya csomag- és kreditcsomag-checkoutját, Stripe-visszairányításait, a /payment hidat, webhookokat, számlázási frissítéseket és vásárlás utáni ellenőrzéseket.

Ezt a fizetési checkout útmutatót akkor használd, amikor meg kell értened, mi történik egy Rivya csomag 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 checkout folyamat nem a Stripe-on é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

Jelenleg a checkout könnyebben érthető, ha három szakaszra bontod:

A Rivya létrehozza a checkout munkamenetet
a felhasználó befejezi a Stripe Checkout folyamatot
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 checkout

A checkout jelenleg olyan helyekről indul, amelyek már illeszkednek a felhasználói szándékhoz:

Árazás
/settings/billing
/settings/credits

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

előfizetési csomag checkout
egyszeri kreditcsomag checkout

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

A csomag-checkout és a kreditcsomag-checkout hasonló, de nem ugyanaz

A csomag-checkout előfizetés formájú.

A kreditcsomag-checkout egyszeri tárcafeltöltés formájú.

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 Stripe sikerpillanat később eltérő termékfelületre küldhet 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 pollolni
csak ezután visszairányítani a megfelelő appré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 az igazi oka annak, hogy a termék a /payment oldalon vár, ahelyett, hogy azonnal visszadobná a felhasználót az appba.

Miért számítanak továbbra is a webhookok, ha a `/payment` pollol?

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

Továbbra is a webhookok frissítik a tartós backend á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

Checkout után a legtisztább ellenőrzési út:

hagyd, hogy a /payment befejezze a folyamatát
ellenőrizd a /settings/billing oldalt, ha a vásárlás csomag volt
ellenőrizd a /settings/credits oldalt, ha a vásárlás kreditcsomag volt
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 csak checkout 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 checkout 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.

Checkout állapot ellenőrzőlista

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

Erősítsd meg, honnan indult a Checkout: nyilvános árazásból, számlázási beállításokból vagy 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-, csomag-, invoice- és tárcaállapotot, 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 újrapróbálod, ha a felhasználó régi csomagot, hiányzó krediteket, duplikált Checkout ablakokat, sikertelen fizetést vagy olyan sikeres Stripe nyugtát lát, amely még nem tükröződik a Rivyában.

Rivya fizetési és checkout útmutató