Un abonnement Stripe de bout en bout : les cas qu'on oublie
Sur un SaaS, j'ai mis en place un abonnement avec Stripe. Le premier paiement est la partie simple. Le reste arrive ensuite, tout seul : renouvellements, échecs de paiement, annulations. Stripe en informe ton applicatio
Sur un SaaS, j'ai mis en place un abonnement avec Stripe. Le premier paiement est la partie simple. Le reste arrive ensuite, tout seul : renouvellements, échecs de paiement, annulations.
Stripe en informe ton application par webhooks. Selon sa documentation, la majeure partie de l'activité d'un abonnement est asynchrone, donc c'est là que se trouvent les cas qu'on oublie.
switch (event.type) {
case "invoice.paid":
// récupérer l'abonnement, vérifier qu'il est "active", prolonger l'accès
break;
case "invoice.payment_failed":
// prévenir le client
break;
case "customer.subscription.deleted":
// retirer l'accès
break;
case "charge.dispute.created":
// décider : envoyer des preuves, restreindre l'accès
break;
}
Quatre points à ne pas rater.
1. L'accès se décide sur l'événement, pas au retour du paiement. À la réception de invoice.paid, récupère l'abonnement et vérifie qu'il est bien active avant de prolonger l'accès. Une facture payée ne le rend pas toujours actif.
2. Les échecs de paiement ont des suites. invoice.payment_failed : prévenir le client. Un abonnement past_due : lui demander de mettre sa carte à jour. canceled ou unpaid : retirer l'accès.
3. Un webhook qui répond mal est rejoué. En production, Stripe réessaie pendant 3 jours au maximum. Traiter deux fois le même événement ne doit donc rien casser. Et vérifie toujours que l'événement vient bien de Stripe, avec la signature.
4. Les litiges et remboursements. Si tu ne t'abonnes pas à charge.dispute.created et charge.refunded, ton application ne l'apprend que quand tu ouvres le Dashboard.
Un abonnement n'est pas fini quand le premier paiement passe. Il est fini quand tu sais ce que ton application fait pour chaque événement.
Amine Affif, développeur full-stack à Paris. amineaffif.com
Originally published by Dev.to WebDev. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.