Guide des Événements Webhook

Dodo Payments fournit des notifications webhook en temps réel pour vous tenir informé des événements critiques liés aux transactions, abonnements, remboursements, litiges et gestion des clés de licence. Ci-dessous se trouve un guide détaillé de ces événements, classés pour plus de clarté, ainsi que des conseils et considérations pour leur mise en œuvre.

Événements de Paiement

Event Name	Event Type	Description
Payment Succeeded	`payment.succeeded`	Déclenché lorsqu’un paiement est traité avec succès.
Payment Failed	`payment.failed`	Se produit lorsqu’une tentative de paiement échoue en raison d’erreurs, de cartes refusées ou d’autres problèmes.
Payment Processing	`payment.processing`	Indique qu’un paiement est en cours de traitement.
Payment Cancelled	`payment.cancelled`	Déclenché lorsqu’un paiement est annulé avant son achèvement.

Événements de Remboursement

Event Name	Event Type	Description
Refund Succeeded	`refund.succeeded`	Déclenché lorsqu’un remboursement est traité avec succès.
Refund Failed	`refund.failed`	Se produit lorsqu’une tentative de remboursement échoue en raison d’erreurs de traitement ou d’autres problèmes.

Événements de Litige

Event Name	Event Type	Description
Dispute Opened	`dispute.opened`	Déclenché lorsqu’un client ouvre un litige.
Dispute Expired	`dispute.expired`	Indique qu’un litige a expiré sans résolution.
Dispute Accepted	`dispute.accepted`	Déclenché lorsqu’un commerçant accepte le litige.
Dispute Cancelled	`dispute.cancelled`	Se produit lorsqu’un litige est annulé par le client ou le système.
Dispute Challenged	`dispute.challenged`	Déclenché lorsqu’un commerçant conteste un litige.
Dispute Won	`dispute.won`	Indique que le commerçant a remporté un litige.
Dispute Lost	`dispute.lost`	Se produit lorsque le commerçant perd un litige.

Événements d’Abonnement

Nom de l’événement	Type d’événement	Description
Abonnement actif	`subscription.active`	Indique qu’un abonnement est désormais actif et que des frais récurrents sont planifiés.
Abonnement mis à jour	`subscription.updated`	Déclenché lorsqu’un champ de l’abonnement est mis à jour (synchronisation en temps réel sans interrogation périodique).
Abonnement en attente	`subscription.on_hold`	Déclenché lorsqu’un abonnement est temporairement mis en attente en raison de l’échec de son renouvellement.
Abonnement suspendu	`subscription.paused`	Déclenché lorsqu’un abonnement est suspendu.
Abonnement réactivé	`subscription.unpaused`	Déclenché lorsqu’un abonnement suspendu est repris.
Abonnement renouvelé	`subscription.renewed`	Se produit lorsqu’un abonnement est renouvelé avec succès.
Plan d’abonnement modifié	`subscription.plan_changed`	Déclenché lorsqu’un abonnement est mis à niveau, rétrogradé ou modifié avec des modules complémentaires différents.
Mode de paiement de l’abonnement mis à jour	`subscription.update_payment_method`	Envoyé lorsque le mode de paiement d’un abonnement est mis à jour. Contient la charge utile de l’abonnement.
Abonnement annulé	`subscription.cancelled`	Déclenché lorsqu’un abonnement est annulé par le marchand ou le client.
Échec de l’abonnement	`subscription.failed`	Indique l’échec d’un abonnement. Cela signifie que nous n’avons pas pu créer un mandat.
Abonnement expiré	`subscription.expired`	Déclenché lorsqu’un abonnement arrive au terme de sa durée et expire.

Événements de Clé de Licence

Event Name	Event Type	Description
License Key Created	`license_key.created`	Déclenché lorsqu’une nouvelle clé de licence est créée pour un produit.

Événements d’Octroi de Droits

Nom de l’Événement	Type d’Événement	Description
Octroi Créé	`entitlement_grant.created`	Un nouvel octroi de droits est créé pour un client. Les octrois de clé de licence arrivent `delivered` ; les octrois basés sur OAuth (Discord, GitHub, Notion) arrivent `pending`.
Octroi Livré	`entitlement_grant.delivered`	L’exécution de l’octroi est terminée — clé de licence émise, liens de fichiers résolus, ou accès à la plateforme accordé.
Échec de l’Octroi	`entitlement_grant.failed`	L’exécution de l’octroi a échoué ; inspectez `error_code` et `error_message`.
Octroi Révoqué	`entitlement_grant.revoked`	L’accès est retiré ; inspectez `revocation_reason` (état de l’abonnement, remboursement, changement de plan, ou manuel).

Pour les schémas de charge utile détaillés, les événements d’exemple et la référence complète revocation_reason, voir Webhooks d’Octroi de Droits.

Événements de Crédit

Nom de l’événement	Type d’événement	Description
Crédit ajouté	`credit.added`	Déclenché lorsque des crédits sont accordés à un client (abonnement, unique, complément ou API).
Crédit déduit	`credit.deducted`	Se produit lorsque des crédits sont consommés par l’utilisation ou le débit manuel.
Crédit expiré	`credit.expired`	Déclenché lorsque des crédits inutilisés expirent après la période de validité configurée.
Crédit reporté	`credit.rolled_over`	Se produit lorsque des crédits inutilisés sont reportés à une nouvelle dotation à la fin du cycle.
Report annulé	`credit.rollover_forfeited`	Déclenché lorsque des crédits sont annulés parce que le nombre maximum de reports a été atteint.
Surcharge facturée	`credit.overage_charged`	Se produit lorsque des frais de surcharge sont appliqués pour une utilisation au-delà du solde zéro.
Réinitialisation de surcharge	`credit.overage_reset`	Déclenché lorsque les frais de surcharge accumulés sont réinitialisés (par exemple, au début d’un nouveau cycle de facturation).
Ajustement manuel	`credit.manual_adjustment`	Déclenché lorsqu’un ajustement manuel de crédit ou de débit est effectué.
Solde bas	`credit.balance_low`	Déclenché lorsque le solde de crédit tombe en dessous du seuil configuré.

Événements de Recouvrement

Nom de l’Événement	Type d’Événement	Description
Panier Abandonné Détecté	`abandoned_checkout.detected`	Déclenché lorsqu’un panier incomplet ou échoué est détecté après 60 minutes.
Panier Abandonné Récupéré	`abandoned_checkout.recovered`	Se produit lorsqu’un client complète le paiement via un lien de recouvrement.

Pour des schémas de charge utile détaillés, des descriptions de champs et des exemples de gestionnaire, voir Webhooks de Récupération.

Événements de Relance

Nom de l’Événement	Type d’Événement	Description
Relance Commencée	`dunning.started`	Déclenché lorsqu’une tentative de relance commence pour un abonnement mis en pause ou annulé.
Relance Récupérée	`dunning.recovered`	Se produit lorsqu’un client met à jour son moyen de paiement et que la charge résultante réussit.

Pour des schémas de charge utile détaillés, descriptions de champs et exemples de gestionnaires, voir Webhooks de Recouvrement.

Événements de versement

Ces événements suivent le transfert de vos fonds de Dodo Payments vers votre compte bancaire, en reflétant les statuts des versements affichés dans le tableau de bord. Le payload est un objet de versement ayant la même structure qu’une entrée de GET /payouts.

Nom de l’événement	Type d’événement	Description
Versement créé	`payout.created`	Déclenché lorsqu’un versement est créé, soit par le cycle de versement automatique, soit en dehors du cycle.
Versement en cours	`payout.in_progress`	Se produit lorsque la date d’échéance du versement arrive et que son traitement commence.
Versement en attente	`payout.on_hold`	Déclenché lorsqu’un versement est suspendu ou placé en vérification.
Versement réussi	`payout.success`	Se produit lorsque le versement vers votre compte bancaire est traité avec succès.
Échec du versement	`payout.failed`	Déclenché lorsqu’un versement échoue. Les fonds et les frais sont recrédités sur votre portefeuille.

Ne supposez pas que les événements de versement sont terminaux ou strictement ordonnés. payout.failed peut légitimement arriver après payout.success lorsqu’une banque retourne le virement, et payout.success peut arriver après payout.failed lorsqu’un versement ayant échoué est ensuite récupéré. Traitez toujours le statut du payload comme l’état actuel.

payout.created était précédemment émis sous la forme de payout.not_initiated. Si vous disposez d’un endpoint existant filtrant sur payout.not_initiated, mettez à jour le filtre pour utiliser payout.created afin qu’il continue de fonctionner.

Pour consulter les schémas détaillés des payloads, les descriptions des champs et des exemples de handlers, voir Webhooks de versement. Ces événements webhook sont conçus pour fournir aux marchands les mises à jour essentielles nécessaires à la gestion efficace de leurs opérations. Implémentez des handlers robustes pour chaque événement pertinent dans votre intégration webhook afin de garantir un fonctionnement fluide et fiable.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Événements de Paiement

Événements de Remboursement

Événements de Litige

Événements d’Abonnement

Événements de Clé de Licence

Événements d’Octroi de Droits

Événements de Crédit

Événements de Recouvrement

Événements de Relance

Événements de versement

​Événements de Paiement

​Événements de Remboursement

​Événements de Litige

​Événements d’Abonnement

​Événements de Clé de Licence

​Événements d’Octroi de Droits

​Événements de Crédit

​Événements de Recouvrement

​Événements de Relance

​Événements de versement

Événements de Paiement

Événements de Remboursement

Événements de Litige

Événements d’Abonnement

Événements de Clé de Licence

Événements d’Octroi de Droits

Événements de Crédit

Événements de Recouvrement

Événements de Relance

Événements de versement