Förstå Rivyas plan- och credit-pack-checkout, Stripe-redirects, /payment-bryggan, webhooks, faktureringsuppdateringar och köpkontroller.

Använd den här guiden för betalningscheckout när du behöver förstå vad som händer efter att du köpt en plan eller ett credit pack i Rivya.

Det människor oftast missförstår om betalning i Rivya är detta:

Att Stripe slutför betalningen är inte det sista steget. Produkten måste fortfarande komma ikapp och spegla ändringen korrekt.

Det är därför checkoutflödet inte slutar hos Stripe, och det slutar inte i samma ögonblick som webbläsaren kommer tillbaka.

Betalningsflödet har tre verkliga steg

Just nu är checkout enklare att förstå om du delar upp det i tre steg:

Rivya skapar checkoutsessionen
användaren slutför Stripe Checkout
Rivya väntar tills produktstatusen blir pålitlig igen

Det tredje steget är exakt varför /payment finns.

Var checkout kan starta

Checkout startar för närvarande från platser som redan matchar användarens avsikt:

Pricing
/settings/billing
/settings/credits

Och de två huvudsakliga köpformerna är:

checkout för prenumerationsplan
checkout för engångs-credit-pack

Det är olika kommersiella beslut, men de går ändå ihop i samma bekräftelseväg.

Plancheckout och credit-pack-checkout är lika, men inte samma sak

Plancheckout är prenumerationsformad.

Credit-pack-checkout är formad som en engångspåfyllning av plånboken.

Den skillnaden spelar roll eftersom Rivya efter betalning behöver veta om den ska uppdatera:

prenumerationsstatus
eller plånboksstatus

Det är därför samma Stripe-success-ögonblick fortfarande kan skicka dig tillbaka till olika produktytor efteråt.

Varför `/payment` finns överhuvudtaget

/payment är inte en kvittosida i vanlig mening.

Det är en bearbetningsbrygga.

Dess jobb är att:

läsa Stripe session_id
kontrollera om betalningsposten på produktsidan har avräknats
fortsätta polla en kort period vid behov
först därefter skicka dig tillbaka till rätt del av appen

Det gör den mer lik en statussynkroniseringssida än en innehållssida.

När är en betalning "verkligen klar" ur produktens perspektiv?

Ur användarens perspektiv känns betalningen klar när Stripe säger att den lyckades.

Ur produktens perspektiv är betalningen bara verkligen klar när kontostatusen synligt har uppdaterats i Rivya.

Det betyder vanligtvis:

betalningsposten är markerad som paid eller slutförd
prenumerations- eller plånbokseffekter är synliga
du kan tryggt gå tillbaka till billing eller credits utan att se gammal status

Det är den verkliga orsaken till att produkten väntar på /payment i stället för att omedelbart kasta tillbaka användaren in i appen.

Varför webhooks fortfarande spelar roll även om `/payment` pollar

/payment ersätter inte Stripe webhooks.

Webhooks är fortfarande det som uppdaterar hållbar backendstatus.

Sidan /payment finns så att upplevelsen kan vänta tills den statusen speglas tillräckligt väl för att vara pålitlig innan redirect.

Det är skillnaden mellan:

"Stripe behandlade något"
och "Rivya visar nu tydligt den ändringen"

Vart du går efter betalning

Returvägen är avsiktligt kopplad till vad som ändrades.

Om köpet gällde prenumeration skickas du i allmänhet tillbaka mot billing.

Om köpet gällde ett credit pack skickas du i allmänhet tillbaka mot credits.

Det är inte kosmetisk routing. Det matchar frågan användare vanligtvis har direkt efter betalning:

uppdaterades min plan?
eller uppdaterades min plånbok?

Vad timeout eller fel faktiskt betyder

Om /payment får timeout eller misslyckas betyder det inte automatiskt att själva betalningen försvann.

Oftare betyder det något av detta:

betalningsposten på produktsidan har inte avräknats ännu
redirecten väntar på status som fortfarande håller på att komma ikapp
kontosidan skulle fortfarande se gammal ut om användaren skickades vidare för tidigt

Det är därför ett timeoutläge är bättre än ett falskt successläge. Det säger användaren att produktbekräftelsen är den del som fortfarande inte är klar.

Det bästa sättet att kontrollera om betalningen verkligen landade

Efter checkout är den renaste verifieringsvägen:

låt /payment slutföra sitt flöde
kontrollera /settings/billing om köpet var en plan
kontrollera /settings/credits om köpet var ett paket
kontrollera Notifications Center om kontot fortfarande verkar osynkat

Det är vanligtvis bättre än att uppdatera slumpmässiga sidor och gissa.

Betalning blir också kontominne

Betalning är inte bara en checkoutåtgärd. Den blir också del av kontohistoriken genom varaktiga händelser som:

prenumeration startad
prenumeration förnyad
betalning misslyckades
credit-paket tillagt

Det är därför aviseringar också spelar roll här. Att stänga Stripe-fliken är inte slutet på kontoberättelsen.

En bättre mental modell

Det enklaste sättet att tänka på Rivya-checkout är:

Stripe hanterar pengaflödet
/payment hanterar produktens återinträde

Om du håller de två rollerna isär blir hela flödet lättare att resonera om.

Läs vidare

Checklista för checkoutstatus

När ett köp ser ofärdigt eller förvirrande ut, kontrollera:

Bekräfta var Checkout startade: public pricing, billing inställningar eller credits inställningar.
Kontrollera om Stripe slutförde betalningen och returnerade användaren till /payment.
Vänta tills Rivya har uppdaterat prenumeration, paket, invoice och plånboksstatus innan du startar en ny betald uppgift.
Använd billing-sidor för prenumerationer och credits-sidor för paket eller plånbokshistorik.
Behandla inte en browser redirect som bevis för att webhook och kontostatus redan har avräknats.

Kontrollera igen innan du försöker betala på nytt

Kontrollera igen innan du försöker på nytt om användaren ser en gammal plan, saknade credits, dubbla Checkout-fönster, misslyckad betalning eller ett lyckat Stripe-kvitto som ännu inte syns i Rivya.

Rivyas guide för betalning och checkout