Rivya-guide for betaling og checkout

Bruk denne guiden for betaling og checkout når du trenger å forstå hva som skjer etter at du kjøper en plan eller credit-pakke i Rivya.

Det folk vanligvis misforstår om betaling i Rivya, er dette:

At Stripe fullfører betalingen, er ikke det siste steget. Produktet må fortsatt hente seg inn og vise endringen riktig.

Derfor slutter ikke checkout-flyten hos Stripe, og den slutter ikke i det øyeblikket nettleseren kommer tilbake.

Betalingsflyten har tre reelle stadier

Akkurat nå er checkout enklere å forstå hvis du deler den i tre stadier:

1. Rivya oppretter checkout-økten
2. brukeren fullfører Stripe Checkout
3. Rivya venter på at produkttilstanden blir pålitelig igjen

Det tredje stadiet er nøyaktig hvorfor /payment finnes.

Hvor checkout kan starte

Checkout starter for tiden fra steder som allerede matcher brukerens intensjon:

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

De to viktigste kjøpsformene er:

• checkout for abonnementsplan
• checkout for engangs credit-pakke

Dette er ulike kommersielle beslutninger, men de samles likevel i samme bekreftelsesvei.

Plan-checkout og credit-pack-checkout er like, men ikke det samme

Plan-checkout er abonnementsformet.

Credit-pack-checkout er formet som en engangspåfylling av wallet.

Den forskjellen betyr noe fordi Rivya etter betaling må vite om den skal oppdatere:

• abonnementstilstand
• eller wallet-tilstand

Derfor kan samme Stripe-suksessøyeblikk fortsatt sende deg tilbake til ulike produktflater etterpå.

Hvorfor /payment finnes i det hele tatt

/payment er ikke en kvitteringsside i vanlig forstand.

Den er en behandlingsbro.

Jobben dens er å:

• lese Stripe session_id
• sjekke om produktets betalingspost har settled
• fortsette å poll'e i en kort periode hvis det trengs
• først deretter sende deg tilbake til riktig del av appen

Det gjør den mer lik en tilstandssynkroniseringsside enn en innholdsside.

Når er en betaling "virkelig ferdig" fra produktets perspektiv?

Fra brukerens perspektiv føles betalingen fullført når Stripe sier at den fungerte.

Fra produktets perspektiv er betalingen bare virkelig fullført når kontotilstanden er synlig oppdatert i Rivya.

Det betyr vanligvis:

• betalingsposten er merket som paid eller completed
• abonnements- eller wallet-effekter er synlige
• du kan trygt gå tilbake til billing eller credits uten å se gammel tilstand

Dette er den reelle grunnen til at produktet venter på /payment i stedet for å sende brukeren rett tilbake i appen.

Hvorfor webhooks fortsatt betyr noe selv om /payment poller

/payment erstatter ikke Stripe webhooks.

Webhooks er fortsatt det som oppdaterer varig backendtilstand.

/payment-siden finnes slik at opplevelsen kan vente til den tilstanden er reflektert godt nok til å være pålitelig før redirect.

Det er forskjellen mellom:

• "Stripe behandlet noe"
• og "Rivya viser nå tydelig den endringen"

Hvor du går etter betaling

Returveien er med vilje knyttet til det som endret seg.

Hvis kjøpet gjaldt abonnement, sendes du vanligvis tilbake mot billing.

Hvis kjøpet var en credit-pakke, sendes du vanligvis tilbake mot credits.

Det er ikke kosmetisk ruting. Det matcher spørsmålet brukere vanligvis har rett etter betaling:

• ble planen min oppdatert?
• eller ble walleten min oppdatert?

Hva timeout eller feil faktisk betyr

Hvis /payment timer ut eller feiler, betyr det ikke automatisk at selve betalingen forsvant.

Oftere betyr det ett av disse:

• produktets betalingspost har ikke settled ennå
• redirecten venter på tilstand som fortsatt holder på å hente seg inn
• kontosiden ville fortsatt vist gammel tilstand hvis brukeren ble sendt videre for tidlig

Derfor er en timeout-tilstand bedre enn en falsk suksess. Den forteller brukeren at produktbekreftelsen er den delen som fortsatt er ufullstendig.

Den beste måten å sjekke om betalingen faktisk landet

Etter checkout er den reneste verifiseringsveien:

1. la /payment fullføre flyten sin
2. sjekk /settings/billing hvis kjøpet var en plan
3. sjekk /settings/credits hvis kjøpet var en pakke
4. sjekk Varslingssenter hvis kontoen fortsatt ser usynkronisert ut

Dette er vanligvis bedre enn å oppdatere tilfeldige sider og gjette.

Betaling blir også kontominne

Betaling er ikke bare en checkout-handling. Den blir også del av kontohistorikken gjennom varige hendelser som:

• abonnement startet
• abonnement fornyet
• betaling mislyktes
• credit-pakke lagt til

Derfor betyr varsler noe her også. Å lukke Stripe-fanen er ikke slutten på kontohistorien.

En bedre mental modell

Den enkleste måten å tenke på Rivya-checkout på er:

• Stripe håndterer pengebevegelsen
• /payment håndterer produktets re-entry

Hvis du holder disse to rollene adskilt, blir hele flyten lettere å forstå.

Les videre

• Credits og fakturering
• Planer og pakker i Rivya
• Varslingssenter
• Feilsøking i Rivya

Sjekkliste for checkout-tilstand

Når et kjøp ser uferdig eller forvirrende ut, bør du kontrollere:

• Bekreft hvor Checkout startet: offentlig pricing, billing-innstillinger eller credits-innstillinger.
• Sjekk om Stripe fullførte betalingen og sendte brukeren tilbake til /payment.
• Vent på at Rivya oppdaterer subscription-, pack-, invoice- og wallet-tilstand før du starter en ny betalt oppgave.
• Bruk billing-sider for abonnementer og credits-sider for pakker eller wallet-historikk.
• Ikke behandle en nettleserredirect som bevis på at webhook og kontotilstand allerede er settled.

Kontroller på nytt før du prøver betaling igjen

Kontroller på nytt før du prøver igjen hvis brukeren ser en gammel plan, manglende credits, dupliserte Checkout-vinduer, mislykket betaling eller en vellykket Stripe-kvittering som ennå ikke vises i Rivya.