DEV Community

Cover image for Un abonnement Stripe de bout en bout : les cas qu'on oublie
Amine Affif
Amine Affif

Posted on

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 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;
}
Enter fullscreen mode Exit fullscreen mode

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

Top comments (0)