Înțelege checkoutul pentru planuri și pachete de credite Rivya, redirecționările Stripe, pagina intermediară /payment, webhookurile, actualizările de facturare și verificările achiziției.

Folosește acest ghid de checkout pentru plăți când trebuie să înțelegi ce se întâmplă după ce cumperi un plan sau un pachet de credite în Rivya.

Iată ce înțeleg adesea greșit utilizatorii despre plata în Rivya:

Faptul că Stripe finalizează plata nu este ultimul pas. Produsul trebuie să preia și să reflecte corect schimbarea.

De aceea fluxul de checkout nu se încheie în Stripe și nici în momentul în care browserul revine.

Fluxul de plată are trei etape reale

În prezent, checkoutul este mai ușor de înțeles dacă îl împarți în trei etape:

Rivya creează sesiunea de checkout
utilizatorul finalizează Stripe Checkout
Rivya așteaptă ca starea produsului să poată fi considerată din nou corectă

A treia etapă este motivul pentru care există /payment.

De unde poate începe checkoutul

Checkoutul pornește în prezent din locuri care corespund deja intenției utilizatorului:

Prețuri
/settings/billing
/settings/credits

Cele două forme principale de cumpărare sunt:

checkout pentru plan de abonament
checkout unic pentru un pachet de credite

Acestea sunt decizii comerciale diferite, dar ajung în același traseu de confirmare.

Checkoutul unui plan și checkoutul unui pachet de credite sunt similare, dar nu identice

Checkoutul unui plan are forma unui abonament.

Checkoutul unui pachet de credite are forma unei alimentări unice a portofelului.

Această diferență contează deoarece, după plată, Rivya trebuie să știe dacă trebuie să actualizeze:

starea abonamentului
sau starea portofelului

De aceea același eveniment de plată reușită în Stripe te poate întoarce apoi în zone diferite ale produsului.

De ce există `/payment`

/payment nu este o pagină de chitanță în sensul obișnuit.

Este o pagină intermediară de procesare.

Rolul ei este să:

citească session_id primit de la Stripe
verifice dacă înregistrarea plății s-a stabilizat în produs
continue verificarea pentru o perioadă scurtă, dacă este necesar
abia apoi să te redirecționeze în zona potrivită a aplicației

Prin urmare, este mai degrabă o pagină de sincronizare a stării decât una de conținut.

Când este o plată „cu adevărat finalizată” din perspectiva produsului?

Din punctul de vedere al utilizatorului, plata pare finalizată când Stripe confirmă reușita.

Din punctul de vedere al produsului, plata este finalizată doar când starea contului este actualizată vizibil în Rivya.

De obicei, aceasta înseamnă că:

înregistrarea plății este marcată paid sau completed
modificările abonamentului sau portofelului sunt vizibile
poți reveni în siguranță la facturare sau credite fără să vezi o stare veche

Acesta este motivul pentru care produsul așteaptă pe /payment în loc să trimită imediat utilizatorul înapoi în aplicație.

De ce webhookurile contează chiar dacă `/payment` verifică periodic starea

/payment nu înlocuiește webhookurile Stripe.

Webhookurile actualizează în continuare starea persistentă din backend.

Pagina /payment permite interfeței să aștepte până când starea este reflectată corect și poate fi considerată sigură înainte de redirecționare.

Aceasta este diferența dintre:

„Stripe a procesat ceva”
și „Rivya reflectă acum clar schimbarea”

Unde ajungi după plată

Calea de întoarcere este legată intenționat de ceea ce s-a schimbat.

Dacă achiziția a fost legată de abonament, ești trimis de obicei înapoi la facturare.

Dacă achiziția a fost un pachet de credite, ești trimis de obicei înapoi la credite.

Aceasta nu este o rutare cosmetică. Corespunde întrebării pe care utilizatorii o au de obicei imediat după plată:

Mi s-a actualizat planul?
Sau mi s-a actualizat portofelul?

Ce înseamnă de fapt o expirare sau un eșec

Dacă /payment expiră sau eșuează, aceasta nu înseamnă automat că plata în sine a dispărut.

Mai des înseamnă una dintre următoarele:

înregistrarea plății nu s-a stabilizat încă în produs
redirecționarea așteaptă o stare care încă se actualizează
pagina contului ar afișa încă informații vechi dacă utilizatorul ar fi redirecționat prea devreme

De aceea o stare de expirare este mai bună decât una falsă de succes. Îi arată utilizatorului că partea încă incompletă este confirmarea în produs.

Cea mai bună metodă de a verifica dacă plata a fost înregistrată

După checkout, cea mai clară cale de verificare este:

lasă /payment să își termine fluxul
verifică /settings/billing dacă ai cumpărat un plan
verifică /settings/credits dacă ai cumpărat un pachet
verifică Centrul de notificări dacă starea contului pare în continuare nesincronizată

De obicei, este mai bine decât să reîmprospătezi pagini la întâmplare și să ghicești.

Plata devine și parte din istoricul contului

Plata nu este doar o acțiune de checkout. Devine și parte din istoricul contului prin evenimente persistente precum:

abonament început
abonament reînnoit
plată eșuată
pachet de credite adăugat

De aceea notificările contează și aici. Închiderea filei Stripe nu este sfârșitul istoricului contului.

Un model mental mai bun

Cea mai simplă metodă de a înțelege checkoutul Rivya este:

Stripe gestionează transferul banilor
/payment gestionează revenirea în produs

Dacă păstrezi aceste două roluri separate, întregul flux devine mai ușor de înțeles.

Lista de verificare pentru starea checkoutului

Când o achiziție pare neterminată sau neclară, verifică:

Confirmă de unde a început checkoutul: prețuri publice, setări de facturare sau setări de credite.
Verifică dacă Stripe a finalizat plata și a returnat utilizatorul la /payment.
Așteaptă ca Rivya să actualizeze starea abonamentului, pachetului, facturii și portofelului înainte să pornești altă sarcină plătită.
Folosește paginile de facturare pentru abonamente și paginile de credite pentru pachete sau istoricul portofelului.
Nu trata o redirecționare a browserului drept dovadă că webhookul și starea contului s-au stabilizat deja.

Verifică din nou înainte să reîncerci plata

Verifică din nou înainte de o nouă încercare dacă utilizatorul vede un plan neactualizat, credite lipsă, ferestre Checkout duplicate, o plată eșuată sau o chitanță Stripe reușită care nu se reflectă încă în Rivya.

Ghid pentru plată și checkout în Rivya