Dev.to WebDev 🛠 Dev 👁 0 📖 1 min read

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

📰 Read the original article on Dev.to WebDev

Originally published by Dev.to WebDev. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.