Rivya AI -dokumentaatio

Rivyan maksun ja Stripe Checkoutin opas

Ymmärrä Rivyan tilaus- ja krediittipakettien maksut, Stripe-uudelleenohjaukset, /payment-silta, webhookit, laskutuspäivitykset ja ostotarkistukset.

Viimeksi tarkistettu 2026/04/28

Käytä tätä maksun ja Stripe Checkoutin opasta, kun sinun täytyy ymmärtää, mitä tapahtuu Rivyassa tilauspaketin tai krediittipaketin ostamisen jälkeen.

Rivyan maksussa ymmärretään yleensä väärin tämä:

Stripe-maksun valmistuminen ei ole viimeinen vaihe. Tuotteen täytyy vielä ehtiä mukaan ja näyttää muutos oikein.

Siksi maksuprosessi ei pääty Stripeen eikä sillä hetkellä, kun selain palaa takaisin.

Maksuvirrassa on kolme todellista vaihetta

Tällä hetkellä maksuprosessi on helpompi ymmärtää, kun jaat sen kolmeen vaiheeseen:

  1. Rivya luo Checkout-istunnon

  2. käyttäjä viimeistelee Stripe Checkoutin

  3. Rivya odottaa, että tuotteen tila on taas luotettava

Juuri kolmas vaihe on syy siihen, miksi /payment on olemassa.

Mistä maksu voi alkaa

Maksu alkaa tällä hetkellä paikoista, jotka vastaavat jo käyttäjän aikomusta:

Kaksi pääasiallista ostomuotoa ovat:

  • tilauspaketin maksu

  • kertaluonteisen krediittipaketin maksu

Ne ovat eri kaupallisia päätöksiä, mutta ne yhdistyvät silti samaan vahvistuspolkuun.

Tilauspaketin ja krediittipaketin maksut ovat samankaltaisia, mutta eivät samoja

Tilauspaketin maksu on jatkuva tilaus.

Krediittipaketin maksu lisää lompakkoon saldoa kertaluonteisesti.

Tällä erolla on merkitystä, koska maksun jälkeen Rivyan täytyy tietää, pitäisikö sen päivittää:

  • tilauksen tila

  • vai lompakon tila

Siksi sama onnistunut Stripe-maksutapahtuma voi silti palauttaa sinut myöhemmin eri tuotealueille.

Miksi /payment on ylipäätään olemassa

/payment ei ole kuittisivu tavallisessa mielessä.

Se on käsittelysilta.

Sen tehtävä on:

  • lukea Stripen session_id

  • tarkistaa, onko tuotteen puolen maksutietue vakiintunut

  • jatkaa lyhyen aikaa tilakyselyjä tarvittaessa

  • ja vasta sitten ohjata sinut takaisin oikeaan osaan sovellusta

Tämä tekee siitä enemmän tilan synkronointisivun kuin sisältösivun.

Milloin maksu on tuotteen näkökulmasta "oikeasti valmis"?

Käyttäjän näkökulmasta maksu tuntuu valmiilta, kun Stripe sanoo sen onnistuneen.

Tuotteen näkökulmasta maksu on oikeasti valmis vasta, kun tilin tila näkyy päivittyneenä Rivyassa.

Se tarkoittaa yleensä:

  • maksutietue on merkitty maksetuksi tai valmiiksi

  • tilauksen tai lompakon muutokset näkyvät

  • voit palata turvallisesti laskutukseen tai krediitteihin näkemättä vanhentunutta tilaa

Tämä on todellinen syy siihen, miksi tuote odottaa /payment-sivulla sen sijaan, että käyttäjä heitettäisiin heti takaisin sovellukseen.

Miksi webhookit ovat edelleen tärkeitä, vaikka /payment tarkistaa tilaa

/payment ei korvaa Stripen webhook-mekanismia.

Webhookit päivittävät edelleen pysyvän tilan taustajärjestelmässä.

/payment-sivu on olemassa, jotta käyttökokemus voi odottaa, kunnes tila näkyy tarpeeksi luotettavasti ennen uudelleenohjausta.

Tämä on ero näiden välillä:

  • "Stripe käsitteli jotakin"

  • ja "Rivya näyttää nyt selvästi tämän muutoksen"

Minne menet maksun jälkeen

Paluu on tarkoituksella sidottu siihen, mikä muuttui.

Jos osto liittyi tilaukseen, sinut ohjataan yleensä laskutukseen.

Jos osto oli krediittipaketti, sinut ohjataan yleensä krediitteihin.

Se ei ole kosmeettista reititystä. Se vastaa kysymystä, joka käyttäjillä yleensä on heti maksamisen jälkeen:

  • päivittyikö tilauspakettini?

  • vai päivittyikö lompakkoni?

Mitä aikakatkaisu tai epäonnistuminen oikeasti tarkoittaa

Jos /payment menee aikakatkaisutilaan tai epäonnistuu, se ei automaattisesti tarkoita, että maksu katosi.

Useammin se tarkoittaa jotakin näistä:

  • tuotteen puolen maksutietue ei ole vielä vakiintunut

  • uudelleenohjaus odottaa tilaa, joka on vielä ottamassa kiinni

  • tilisivu näyttäisi yhä vanhentuneelta, jos käyttäjä ohjattaisiin takaisin liian aikaisin

Siksi aikakatkaisutila on parempi kuin teennäinen onnistumistila. Se kertoo käyttäjälle, että tuotteen vahvistus on se osa, joka on vielä kesken.

Paras tapa tarkistaa, menikö maksu oikeasti perille

Maksun jälkeen selkein tarkistuspolku on:

  1. anna /payment-sivun viimeistellä virta

  2. tarkista /settings/billing, jos osto oli tilauspaketti

  3. tarkista /settings/credits, jos osto oli krediittipaketti

  4. tarkista ilmoituskeskus, jos tili näyttää edelleen epäsynkroniselta

Tämä on yleensä parempi kuin satunnaisten sivujen päivittäminen ja arvaaminen.

Maksusta tulee myös tilin muistia

Maksu ei ole vain Checkout-toiminto. Siitä tulee myös osa tilihistoriaa pysyvien tapahtumien kautta, kuten:

  • tilaus aloitettu

  • tilaus uusittu

  • maksu epäonnistui

  • krediittipaketti lisätty

Siksi ilmoituksilla on merkitystä myös tässä. Stripe-välilehden sulkeminen ei ole tilitarinan loppu.

Parempi ajattelumalli

Yksinkertaisin tapa ajatella Rivyan maksuprosessia on:

  • Stripe hoitaa rahaliikkeen

  • /payment hoitaa paluun tuotteen puolelle

Kun pidät nämä kaksi roolia erillään, koko virta on helpompi ymmärtää.

Lue seuraavaksi

Maksutilan tarkistuslista

Kun osto näyttää keskeneräiseltä tai hämmentävältä, tarkista:

  • Vahvista, mistä Checkout alkoi: julkisesta hinnoittelusta, laskutusasetuksista vai krediittiasetuksista.

  • Tarkista, viimeisteltiinkö maksu Stripessä ja palautettiinko käyttäjä /payment-sivulle.

  • Odota, että Rivya päivittää tilauksen, krediittipaketin, laskun ja lompakon tilan ennen toisen maksullisen tehtävän aloittamista.

  • Käytä laskutussivuja tilauksille ja krediittisivuja krediittipaketeille tai lompakkohistorialle.

  • Älä käsittele selaimen uudelleenohjausta todisteena siitä, että webhook ja tilin tila ovat jo vakiintuneet.

Tarkista uudelleen ennen maksun yrittämistä uudelleen

Tarkista uudelleen ennen uutta yritystä, jos käyttäjä näkee vanhentuneen tilauspaketin, puuttuvat krediitit, päällekkäiset Checkout-ikkunat, epäonnistuneen maksun tai onnistuneen Stripe-kuitin, joka ei vielä näy Rivyassa.