Ghid pentru plata si checkout in Rivya

Foloseste acest ghid de checkout pentru plati cand trebuie sa intelegi ce se intampla dupa ce cumperi un plan sau un pachet de credite in Rivya.

Ce inteleg oamenii gresit de obicei despre plata in Rivya este asta:

Faptul ca Stripe finalizeaza plata nu este ultimul pas. Produsul trebuie inca sa recupereze si sa reflecte corect acea schimbare.

De aceea fluxul de checkout nu se termina pe Stripe si nu se termina in momentul in care browserul revine.

Fluxul de plata are trei etape reale

In prezent, checkoutul este mai usor de inteles daca il imparti in trei etape:

1. Rivya creeaza sesiunea de checkout
2. utilizatorul finalizeaza Stripe Checkout
3. Rivya asteapta ca starea produsului sa devina din nou de incredere

A treia etapa este exact motivul pentru care exista /payment.

De unde poate incepe checkoutul

Checkoutul porneste in prezent din locuri care se potrivesc deja intentiei utilizatorului:

• Preturi
• /settings/billing
• /settings/credits

Iar cele doua forme principale de cumparare sunt:

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

Acestea sunt decizii comerciale diferite, dar converg totusi in aceeasi cale de confirmare.

Checkoutul de plan si checkoutul de pachet de credite sunt similare, dar nu identice

Checkoutul de plan are forma de abonament.

Checkoutul de pachet de credite are forma unei incarcari unice de portofel.

Aceasta diferenta conteaza deoarece dupa plata Rivya trebuie sa stie daca ar trebui sa actualizeze:

• starea abonamentului
• sau starea portofelului

De aceea acelasi moment de succes Stripe te poate trimite apoi inapoi catre suprafete de produs diferite.

De ce exista /payment

/payment nu este o pagina de chitanta in sensul obisnuit.

Este o punte de procesare.

Jobul ei este sa:

• citeasca session_id de la Stripe
• verifice daca inregistrarea de plata din produs s-a asezat
• continue polling pentru o perioada scurta, daca este nevoie
• abia apoi sa te redirectioneze inapoi in partea potrivita a aplicatiei

Asta o face mai degraba o pagina de sincronizare de stare decat o pagina de continut.

Cand este o plata "cu adevarat gata" din perspectiva produsului?

Din punctul de vedere al utilizatorului, plata pare completa cand Stripe spune ca a functionat.

Din punctul de vedere al produsului, plata este cu adevarat completa doar cand starea contului este vizibil actualizata in Rivya.

De obicei, asta inseamna:

• inregistrarea de plata este marcata ca paid sau completed
• efectele de abonament sau portofel sunt vizibile
• poti reveni in siguranta la facturare sau credite fara sa vezi stare veche

Acesta este motivul real pentru care produsul asteapta pe /payment in loc sa arunce imediat utilizatorul inapoi in aplicatie.

De ce webhookurile conteaza in continuare chiar daca /payment face polling

/payment nu inlocuieste webhookurile Stripe.

Webhookurile sunt in continuare cele care actualizeaza starea durabila din backend.

Pagina /payment exista ca experienta sa poata astepta pana cand acea stare este reflectata suficient de bine pentru a fi de incredere inainte de redirect.

Aceasta este diferenta dintre:

• "Stripe a procesat ceva"
• si "Rivya reflecta acum clar acea schimbare"

Unde ajungi dupa plata

Calea de intoarcere este legata intentionat de ce s-a schimbat.

Daca achizitia a fost legata de abonament, esti trimis in general inapoi spre facturare.

Daca achizitia a fost un pachet de credite, esti trimis in general inapoi spre credite.

Aceasta nu este rutare cosmetica. Se potriveste cu intrebarea pe care utilizatorii o au de obicei imediat dupa plata:

• mi s-a actualizat planul?
• sau mi s-a actualizat portofelul?

Ce inseamna de fapt un timeout sau un esec

Daca /payment intra in timeout sau esueaza, asta nu inseamna automat ca plata in sine a disparut.

Mai des inseamna una dintre acestea:

• inregistrarea de plata din produs nu s-a asezat inca
• redirectul asteapta o stare care inca recupereaza
• pagina de cont ar arata inca invechita daca utilizatorul ar fi redirectionat prea devreme

De aceea o stare de timeout este mai buna decat o stare falsa de succes. Ii spune utilizatorului ca partea inca incompleta este confirmarea produsului.

Cea mai buna metoda de a verifica daca plata a intrat

Dupa checkout, cea mai curata cale de verificare este:

1. lasa /payment sa isi termine fluxul
2. verifica /settings/billing daca achizitia a fost un plan
3. verifica /settings/credits daca achizitia a fost un pachet
4. verifica Centrul de notificari daca starea contului inca pare nesincronizata

De obicei, asta este mai bine decat sa reimprospatezi pagini aleatorii si sa ghicesti.

Plata devine si memorie de cont

Plata nu este doar o actiune de checkout. Devine si parte din istoricul contului prin evenimente durabile precum:

• abonament inceput
• abonament reinnoit
• plata esuata
• pachet de credite adaugat

De aceea notificarile conteaza si aici. Inchiderea tabului Stripe nu este sfarsitul povestii contului.

Un model mental mai bun

Cea mai simpla metoda de a gandi checkoutul Rivya este:

• Stripe gestioneaza miscarea banilor
• /payment gestioneaza reintrarea pe partea de produs

Daca pastrezi aceste doua roluri separate, intregul flux devine mai usor de inteles.

Citeste mai departe

• Credite si facturare
• Planuri si pachete in Rivya
• Centrul de notificari
• Depanare in Rivya

Lista de verificare pentru starea checkoutului

Cand o cumparare pare neterminata sau confuza, verifica:

• Confirma de unde a inceput Checkoutul: preturi publice, setari de facturare sau setari de credite.
• Verifica daca Stripe a finalizat plata si a returnat utilizatorul la /payment.
• Asteapta ca Rivya sa actualizeze starea abonamentului, pachetului, facturii si portofelului inainte sa pornesti alta sarcina platita.
• Foloseste paginile de facturare pentru abonamente si paginile de credite pentru pachete sau istoricul portofelului.
• Nu trata un redirect de browser ca dovada ca webhookul si starea contului s-au asezat deja.

Reverifica inainte sa incerci din nou plata

Reverifica inainte de reincercare daca utilizatorul vede un plan invechit, credite lipsa, ferestre Checkout duplicate, plata esuata sau o chitanta Stripe reusita care nu se reflecta inca in Rivya.