Comprenez le checkout des forfaits et packs de crédits Rivya, les redirections Stripe, le pont /payment, les webhooks, les mises à jour de facturation et les vérifications d'achat.

Utilisez ce guide du paiement checkout lorsque vous devez comprendre ce qui se passe après l'achat d'un forfait ou d'un pack de crédits dans Rivya.

Ce que les gens comprennent souvent mal à propos du paiement dans Rivya est ceci :

Le paiement terminé dans Stripe n'est pas la dernière étape. Le produit doit encore se mettre à jour et refléter correctement ce changement.

C'est pourquoi le flux de checkout ne se termine pas sur Stripe, et ne se termine pas non plus au moment où le navigateur revient.

Le flux de paiement a trois vraies étapes

Aujourd'hui, le checkout est plus simple à comprendre si vous le divisez en trois étapes :

Rivya crée la session de checkout
l'utilisateur termine Stripe Checkout
Rivya attend que l'état produit redevienne fiable

Cette troisième étape est exactement la raison d'être de /payment.

Où le checkout peut commencer

Le checkout démarre actuellement depuis des endroits qui correspondent déjà à l'intention de l'utilisateur :

Tarifs
/settings/billing
/settings/credits

Et les deux principales formes d'achat sont :

checkout de forfait d'abonnement
checkout de pack de crédits ponctuel

Ce sont des décisions commerciales différentes, mais elles convergent quand même vers le même chemin de confirmation.

Le checkout de forfait et le checkout de pack de crédits sont similaires, mais pas identiques

Le checkout de forfait a une forme d'abonnement.

Le checkout de pack de crédits ressemble à une recharge ponctuelle du portefeuille.

Cette différence compte parce qu'après le paiement, Rivya doit savoir s'il doit actualiser :

l'état de l'abonnement
ou l'état du portefeuille

C'est pourquoi le même moment de succès Stripe peut encore vous renvoyer ensuite vers des surfaces produit différentes.

Pourquoi `/payment` existe

/payment n'est pas une page de reçu au sens habituel.

C'est un pont de traitement.

Son rôle est de :

lire le session_id Stripe
vérifier si l'enregistrement de paiement côté produit est stabilisé
continuer à interroger pendant une courte période si nécessaire
puis seulement vous rediriger vers la bonne partie de l'app

Cela en fait davantage une page de synchronisation d'état qu'une page de contenu.

Quand un paiement est-il « vraiment terminé » du point de vue du produit ?

Du point de vue utilisateur, le paiement semble terminé dès que Stripe dit qu'il a fonctionné.

Du point de vue du produit, le paiement n'est vraiment terminé que lorsque l'état du compte est visiblement mis à jour dans Rivya.

Cela signifie généralement :

l'enregistrement de paiement est marqué comme payé ou terminé
les effets d'abonnement ou de portefeuille sont visibles
vous pouvez revenir en toute sécurité à la facturation ou aux crédits sans voir d'état obsolète

C'est la vraie raison pour laquelle le produit attend sur /payment au lieu de renvoyer immédiatement l'utilisateur dans l'app.

Pourquoi les webhooks comptent encore même si `/payment` interroge

/payment ne remplace pas les webhooks Stripe.

Les webhooks restent ce qui met à jour l'état backend durable.

La page /payment existe pour que l'expérience puisse attendre que cet état soit suffisamment reflété pour être fiable avant la redirection.

C'est la différence entre :

« Stripe a traité quelque chose »
et « Rivya reflète maintenant clairement ce changement »

Où vous allez après le paiement

Le chemin de retour est volontairement lié à ce qui a changé.

Si l'achat concernait l'abonnement, vous êtes généralement renvoyé vers la facturation.

Si l'achat était un pack de crédits, vous êtes généralement renvoyé vers les crédits.

Ce n'est pas un routage cosmétique. Il correspond à la question que les utilisateurs ont habituellement juste après avoir payé :

mon forfait a-t-il été mis à jour ?
ou mon portefeuille a-t-il été mis à jour ?

Ce que signifie vraiment un timeout ou un échec

Si /payment expire ou échoue, cela ne signifie pas automatiquement que le paiement lui-même a disparu.

Le plus souvent, cela signifie l'une de ces choses :

l'enregistrement de paiement côté produit n'est pas encore stabilisé
la redirection attend un état qui est encore en train de se mettre à jour
la page de compte semblerait encore obsolète si l'utilisateur était redirigé trop tôt

C'est pourquoi un état de timeout est meilleur qu'un faux état de succès. Il indique à l'utilisateur que la confirmation produit est la partie encore incomplète.

La meilleure façon de vérifier si le paiement est bien arrivé

Après checkout, le chemin de vérification le plus clair est :

laisser /payment terminer son flux
vérifier /settings/billing si l'achat était un forfait
vérifier /settings/credits si l'achat était un pack
vérifier le Centre de notifications si le compte semble encore désynchronisé

C'est généralement mieux que de rafraîchir des pages au hasard et de deviner.

Le paiement devient aussi mémoire de compte

Le paiement n'est pas seulement une action de checkout. Il devient aussi une partie de l'historique du compte via des événements durables comme :

abonnement démarré
abonnement renouvelé
paiement échoué
pack de crédits ajouté

C'est pourquoi les notifications comptent ici aussi. Fermer l'onglet Stripe n'est pas la fin de l'histoire du compte.

Un meilleur modèle mental

La façon la plus simple de penser le checkout Rivya est :

Stripe gère le mouvement d'argent
/payment gère la réentrée côté produit

Si vous gardez ces deux rôles séparés, tout le flux devient plus facile à comprendre.

Checklist d'état du checkout

Lorsqu'un achat semble incomplet ou confus, vérifiez :

Confirmez où Checkout a commencé : tarifs publics, paramètres de facturation ou paramètres de crédits.
Vérifiez si Stripe a terminé le paiement et renvoyé l'utilisateur vers /payment.
Attendez que Rivya actualise l'abonnement, le pack, la facture et l'état du portefeuille avant de démarrer une autre tâche payante.
Utilisez les pages de facturation pour les abonnements et les pages de crédits pour les packs ou l'historique du portefeuille.
Ne traitez pas une redirection navigateur comme preuve que le webhook et l'état du compte sont déjà stabilisés.

Revérifier avant de réessayer le paiement

Revérifiez avant de réessayer si l'utilisateur voit un forfait obsolète, des crédits manquants, des fenêtres Checkout en double, un paiement échoué ou un reçu Stripe réussi qui n'est pas encore reflété dans Rivya.

Guide du paiement Checkout Rivya