Comprendi checkout di piani e pacchetti crediti Rivya, redirect Stripe, ponte /payment, webhook, aggiornamenti billing e controlli acquisto.

Usa questa guida al checkout di pagamento quando devi capire cosa succede dopo aver acquistato un piano o un pacchetto crediti in Rivya.

Ciò che di solito viene frainteso sui pagamenti in Rivya è questo:

il completamento del pagamento da parte di Stripe non è l'ultimo passaggio. Il prodotto deve ancora allinearsi e riflettere correttamente quel cambiamento.

Ecco perché il flusso di checkout non finisce su Stripe e non finisce nel momento in cui il browser torna indietro.

Il flusso di pagamento ha tre fasi reali

In questo momento, il checkout è più facile da capire se lo dividi in tre fasi:

Rivya crea la sessione di checkout
l'utente completa Stripe Checkout
Rivya aspetta che lo stato prodotto torni affidabile

Questa terza fase è esattamente il motivo per cui esiste /payment.

Da dove può iniziare il checkout

Il checkout attualmente parte da luoghi che corrispondono già all'intento dell'utente:

Prezzi
/settings/billing
/settings/credits

Le due principali forme di acquisto sono:

checkout di un piano in abbonamento
checkout di un pacchetto crediti una tantum

Sono decisioni commerciali diverse, ma convergono comunque nello stesso percorso di conferma.

Checkout piano e checkout pacchetto crediti sono simili, ma non uguali

Il checkout piano ha forma di abbonamento.

Il checkout pacchetto crediti ha forma di ricarica wallet una tantum.

Questa differenza conta perché dopo il pagamento Rivya deve sapere se deve aggiornare:

stato dell'abbonamento
oppure stato del wallet

Ecco perché lo stesso momento di successo Stripe può comunque rimandarti dopo verso superfici di prodotto diverse.

Perché `/payment` esiste

/payment non è una pagina ricevuta nel senso usuale.

È un ponte di elaborazione.

Il suo compito è:

leggere lo session_id di Stripe
controllare se il record di pagamento lato prodotto si è stabilizzato
continuare il polling per un breve periodo se necessario
solo allora reindirizzarti nella parte giusta dell'app

Questo la rende più una pagina di sincronizzazione dello stato che una pagina contenuto.

Quando un pagamento è "davvero completato" dal punto di vista del prodotto?

Dal punto di vista dell'utente, il pagamento sembra completo quando Stripe dice che ha funzionato.

Dal punto di vista del prodotto, il pagamento è davvero completo solo quando lo stato account è visibilmente aggiornato in Rivya.

Di solito significa:

il record di pagamento è segnato come pagato o completato
gli effetti su abbonamento o wallet sono visibili
puoi tornare in sicurezza a billing o credits senza vedere stato obsoleto

Questo è il vero motivo per cui il prodotto aspetta su /payment invece di ributtare subito l'utente nell'app.

Perché i webhook contano ancora anche se `/payment` fa polling

/payment non sostituisce i webhook Stripe.

I webhook restano ciò che aggiorna lo stato backend durevole.

La pagina /payment esiste perché l'esperienza possa aspettare finché quello stato è riflesso abbastanza bene da essere affidabile prima del redirect.

Questa è la differenza tra:

"Stripe ha elaborato qualcosa"
e "Rivya ora riflette chiaramente quel cambiamento"

Dove vai dopo il pagamento

Il percorso di ritorno è intenzionalmente legato a cosa è cambiato.

Se l'acquisto era legato all'abbonamento, di solito vieni rimandato verso billing.

Se l'acquisto era un pacchetto crediti, di solito vieni rimandato verso credits.

Non è routing cosmetico. Corrisponde alla domanda che gli utenti hanno di solito subito dopo aver pagato:

il mio piano si è aggiornato?
oppure si è aggiornato il mio wallet?

Cosa significa davvero un timeout o un fallimento

Se /payment va in timeout o fallisce, non significa automaticamente che il pagamento stesso sia sparito.

Più spesso significa una di queste cose:

il record di pagamento lato prodotto non si è ancora stabilizzato
il redirect sta aspettando uno stato che sta ancora recuperando
la pagina account sembrerebbe ancora obsoleta se l'utente venisse reindirizzato troppo presto

Ecco perché uno stato di timeout è meglio di un falso successo. Dice all'utente che la conferma prodotto è la parte ancora incompleta.

Il modo migliore per verificare se il pagamento è arrivato davvero

Dopo il checkout, il percorso di verifica più pulito è:

lasciare che /payment finisca il suo flusso
controllare /settings/billing se l'acquisto era un piano
controllare /settings/credits se l'acquisto era un pacchetto
controllare Centro notifiche se l'account sembra ancora fuori sync

Di solito è meglio che aggiornare pagine casuali e tirare a indovinare.

Il pagamento diventa anche memoria account

Il pagamento non è solo un'azione di checkout. Diventa anche parte della cronologia account tramite eventi durevoli come:

abbonamento avviato
abbonamento rinnovato
pagamento fallito
pacchetto crediti aggiunto

Ecco perché anche le notifiche contano qui. Chiudere la scheda Stripe non è la fine della storia dell'account.

Un modello mentale migliore

Il modo più semplice di pensare al checkout Rivya è:

Stripe gestisce il movimento del denaro
/payment gestisce il rientro lato prodotto

Se tieni separati questi due ruoli, l'intero flusso diventa più facile da ragionare.

Leggi dopo

Lista di controllo dello stato checkout

Quando un acquisto sembra incompleto o confuso, controlla:

Conferma da dove è partito Checkout: pricing pubblico, impostazioni billing o impostazioni credits.
Controlla se Stripe ha completato il pagamento e riportato l'utente a /payment.
Aspetta che Rivya aggiorni stato di abbonamento, pacchetto, fattura e wallet prima di avviare un'altra attività a pagamento.
Usa le pagine billing per abbonamenti e le pagine credits per pacchetti o cronologia wallet.
Non trattare un redirect del browser come prova che webhook e stato account si siano già stabilizzati.

Ricontrolla prima di riprovare il pagamento

Ricontrolla prima di riprovare se l'utente vede un piano obsoleto, crediti mancanti, finestre Checkout duplicate, pagamento fallito o una ricevuta Stripe riuscita non ancora riflessa in Rivya.

Guida Rivya a pagamento e checkout