Liste complète des événements webhook
Si vous gérez vous-même l’automatisation, vous pouvez le faire par programmation ou avec des outils comme Zapier. Dans les réglages du produit, ajoutez l’URL du webhook dans l’onglet Integrations and webhook. Après un achat, les informations de la transaction y seront envoyées. Vous pouvez générer le webhook avec Zapier ou Make (anciennement Integromat).
Les principaux événements sur lesquels nous filtrons sont identifiés par la clé d’événement et sont les suivants:
- single_product_bought - achat d’un produit unique
- product_assigned - un produit unique a été attribué avec succès à un utilisateur
- product_access_expiring - l’accès à un produit unique va bientôt expirer
- product_access_expired - l’accès au produit unique a expiré
- subscription_created - achat d’un nouvel abonnement
- subscription_plan_changed - changement de formule depuis le panneau Easycart
- subscription_canceled - résiliation de l’abonnement dans le panneau Easycart (valable jusqu’à la fin de la période de facturation)
- subscription_expired - expiration définitive de l’abonnement
- subscription_renewed - renouvellement de l’abonnement
- subscription_renewal_failed - échec du prélèvement pour le renouvellement
- subscription_renewal_upcoming - renouvellement à venir
- subscription_resumed - abonnement renouvelé avec succès
- subscription_deleted - l’abonnement a été définitivement supprimé
- customer_data_changed - modification des données du client
Tous les cas de figure et les réponses des webhooks sont détaillés ci-dessous:
Webhook après l’achat réussi d’un produit unique
Webhook après l’attribution réussie d’un produit
Webhook lorsque l’accès au produit unique arrive à expiration
Webhook après l’expiration de l’accès au produit unique
Webhook après l’achat réussi d’un abonnement
Cet événement est envoyé après l’achat d’un abonnement. À ce stade, l’accès au produit doit être accordé. Important: l’abonnement peut être activé en mode essai. Dans ce cas, la propriété trial_ends_at indique la date de fin. Sinon, elle vaut null.
Webhook après un clic sur Switch to this plan dans le panneau d’abonnement
Le client a la possibilité de basculer vers une autre formule (si elle a été définie) depuis le panneau Easycart. Le nom de la formule transmis au webhook provient d’ici:
- La propriété subscription_plan_name indique vers quelle formule l’utilisateur a basculé
- La propriété subscription_plan_price indique le prix actuel.
Webhook après un clic de l’utilisateur sur Cancel dans le panneau d’abonnement
La propriété subscription_current_period_end indique la date à laquelle la formule doit être désactivée (et donc l’accès au produit retiré).
Webhook après l’expiration de l’abonnement
Événement envoyé lorsque l’abonnement devient inactif à la suite d’une résiliation par le client ou d’une annulation manuelle dans le panneau Stripe, ou lorsque le paiement n’a pas pu être prélevé après un certain nombre de tentatives. C’est à ce moment que l’accès au produit doit être désactivé.
Webhook après un prélèvement réussi pour la période de facturation suivante
Après le prélèvement des frais de la période de facturation, un événement contenant les données suivantes est envoyé.
- La propriété amount_paid correspond au montant prélevé - c’est le montant pour lequel une facture doit être émise
- Les données de facturation se trouvent dans la propriété invoice_data (qui peut valoir null si elle n’est pas disponible)
Webhook en cas d’échec du prélèvement pour la période de facturation suivante
En cas d’échec du prélèvement pour la période de facturation. La propriété error_message contient les informations sur l’erreur.
Webhook X jours avant le prochain prélèvement
Les données suivantes sont envoyées au webhook X jours avant le prochain prélèvement. La propriété subscription_renews_at indique la date à laquelle le prochain prélèvement aura lieu.
Le webhook est envoyé sur la base de l’événement invoice.upcoming de Stripe.
Webhook X jours avant la fin de la période d’essai
Le webhook est identique au précédent, mais si la propriété trial_ends_at n’est pas null, cela signifie qu’il s’agira du premier prélèvement. Dans Stripe, vous pouvez définir combien de jours avant le premier prélèvement une notification doit être envoyée au client. Pour cela:
- Ouvrez les réglages dans Stripe
- Dans la section Prevent failed payments, choisissez le nombre de jours approprié
