Choisissez vos événements Stripe
Commencez par les quatre événements qui couvrent les paiements, les échecs et les annulations. Vous pourrez en ajouter d’autres plus tard.
- checkout.session.completed – un client termine le paiement d’un achat unique ou d’un nouvel abonnement.
- invoice.payment_succeeded – une facture récurrente est payée, y compris les renouvellements d’abonnement.
- invoice.payment_failed – un paiement ou un renouvellement échoue, souvent le premier signe d’un problème de carte.
- customer.subscription.deleted – un abonnement se termine, qu’il soit annulé immédiatement ou en fin de période.
Dans votre gestionnaire de webhook Stripe, transmettez les champs qui comptent.
Vérifiez d’abord la signature Stripe, puis envoyez un appel HTTP à LogsNinja avec le montant en métadonnée – il alimente à la fois l’alerte et le graphique de revenu.
$ curl -X POST https://api.logsninja.com/v1/events \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -d '{ "project": "YOUR_PROJECT_ID", "stream": "payments", "title": "New subscription", "content": "[email protected] subscribed to Pro", "emoji": "💳", "metadata": {"plan": "pro", "amount": 49}, "notify": true }' ✓ Event received ✓ Push sent to 2 devices # revenue chart updated
Déployez-le en toute sécurité
Vérifiez avant de faire confiance
- Vérifiez l’en-tête Stripe-Signature par rapport à votre secret de signature de webhook avant tout traitement.
- Gardez votre clé secrète Stripe et votre jeton API LogsNinja hors du code côté client.
- Ne transmettez jamais de numéro de carte complet ni de CVC – Stripe ne les envoie de toute façon jamais à votre webhook.
Gérez les nouvelles tentatives
- Stripe retente les webhooks non délivrés – renvoyez un 200 rapidement et traitez de façon asynchrone si besoin.
- Utilisez l’ID d’événement Stripe comme clé d’idempotence pour qu’un webhook retenté ne crée pas d’alerte en double.
- Journalisez les échecs de livraison de votre côté ; les événements LogsNinja envoyés plus tard arrivent quand même dans le bon graphique.
Construisez ces graphiques sur votre tableau de bord
Chaque widget ci-dessous exploite les mêmes évènements que vous venez d’envoyer, sans seconde intégration. Le revenu du jour additionne la métadonnée amount du flux payments ; les autres comptent les évènements par titre.
Valeurs d’exemple affichées à titre d’illustration.
Questions fréquentes
Dois-je modifier mon intégration Stripe ?
Non. Conservez votre endpoint webhook Stripe existant. Ajoutez un appel HTTP à LogsNinja dans votre gestionnaire existant, après avoir vérifié la signature.
Quels événements Stripe dois-je ajouter plus tard ?
customer.subscription.created pour les nouveaux essais, charge.refunded pour les remboursements, et invoice.payment_action_required si vous supportez le 3D Secure.
Est-il prudent d’envoyer le montant du paiement à LogsNinja ?
Oui. Le montant est stocké en métadonnée d’événement, le même champ qui alimente votre graphique de revenu. N’envoyez jamais de numéro de carte complet ni de CVC – Stripe ne les envoie de toute façon pas à votre webhook.