Guide des événements Webhook

Dodo Payments émet des événements Webhook à chaque étape du cycle de vie d’un paiement, d’un abonnement, d’un litige, d’un versement, d’un crédit ou d’une clé de licence. Cette page répertorie chaque événement par ressource. Pour consulter les schémas de payload détaillés et des exemples de handlers, reportez-vous aux pages spécifiques aux ressources indiquées ci-dessous.

Événements de paiement

Événement	Se déclenche lorsque
`payment.succeeded`	Un paiement est traité avec succès.
`payment.failed`	Une tentative de paiement échoue en raison de cartes refusées, de fonds insuffisants ou d’autres erreurs.
`payment.processing`	Un paiement est en cours de traitement.
`payment.cancelled`	Un paiement est annulé avant son achèvement.

Pour consulter le schéma de payload complet, reportez-vous à Webhooks de paiement.

Événements de remboursement

Événement	Se déclenche lorsque
`refund.succeeded`	Un remboursement est traité avec succès.
`refund.failed`	Une tentative de remboursement échoue en raison d’erreurs de traitement ou d’autres problèmes.

Pour consulter le schéma de payload complet, reportez-vous à Webhooks de remboursement.

Événements de litige

Événement	Se déclenche lorsque
`dispute.opened`	Un titulaire de carte ouvre un litige concernant un paiement.
`dispute.challenged`	Des preuves ont été soumises pour contester le litige.
`dispute.accepted`	Le litige a été accepté sans être contesté.
`dispute.cancelled`	Le litige a été retiré ou annulé.
`dispute.expired`	Le délai de réponse a expiré sans résolution.
`dispute.won`	Le litige a été résolu en votre faveur.
`dispute.lost`	Le litige a été résolu en faveur du titulaire de la carte.

Pour consulter les schémas de payload détaillés et des exemples de handlers, reportez-vous à Webhooks de litige.

Événements d’abonnement

Événement	Se déclenche lorsque
`subscription.active`	Un abonnement est activé avec succès et les prélèvements récurrents sont planifiés.
`subscription.updated`	Un champ de l’abonnement est modifié (synchronisation en temps réel sans interrogation périodique).
`subscription.past_due`	Un renouvellement échoue et la période de grâce commence ; le client conserve son accès jusqu’à l’échéance.
`subscription.on_hold`	Un abonnement est temporairement suspendu en raison d’un renouvellement échoué.
`subscription.paused`	Un abonnement est mis en pause.
`subscription.unpaused`	Un abonnement en pause reprend.
`subscription.renewed`	Un abonnement est renouvelé avec succès pour la prochaine période de facturation.
`subscription.plan_changed`	Un abonnement est mis à niveau, rétrogradé ou modifié avec des modules complémentaires différents.
`subscription.update_payment_method`	Le moyen de paiement d’un abonnement est mis à jour.
`subscription.cancelled`	Un abonnement est annulé par le marchand ou le client.
`subscription.failed`	La création d’un abonnement échoue lors de la création du mandat.
`subscription.expired`	Un abonnement arrive au terme de sa durée et expire.

Pour consulter les schémas de payload détaillés et des exemples de handlers, reportez-vous à Webhooks d’abonnement.

Événements de clé de licence

Événement	Se déclenche lorsque
`license_key.created`	Une nouvelle clé de licence est créée pour un produit.

Pour consulter le schéma de payload complet, reportez-vous à Webhooks de clé de licence.

Événements d’octroi de droits

Événement	Se déclenche lorsque
`entitlement_grant.created`	Un nouvel octroi de droits est créé pour un client. Les octrois de clés de licence exécutés automatiquement et les octrois de feature flags arrivent avec `status: "Delivered"` et ne déclenchent aucun événement `delivered` distinct. Les autres octrois, y compris les clés de licence exécutées manuellement, arrivent avec `Pending`. Consultez Octroi de droits.
`entitlement_grant.delivered`	L’exécution de l’octroi est terminée — clé de licence délivrée, liens vers les fichiers résolus ou accès à la plateforme accordé.
`entitlement_grant.failed`	L’exécution de l’octroi échoue. Vérifiez `error_code` et `error_message` dans le payload.
`entitlement_grant.revoked`	L’accès est retiré. Vérifiez `revocation_reason` dans le payload.

Pour consulter les schémas de payload détaillés, des exemples d’événements et la référence complète revocation_reason, reportez-vous à Webhooks d’octroi de droits.

Événements de crédit

Événement	Se déclenche lorsque
`credit.added`	Des crédits sont accordés à un client (via un abonnement, un achat unique, un module complémentaire ou l’API).
`credit.deducted`	Des crédits sont consommés par l’utilisation ou un débit manuel.
`credit.expired`	Les crédits inutilisés expirent après la période d’expiration configurée.
`credit.rolled_over`	Les crédits inutilisés sont reportés sur un nouvel octroi à la fin du cycle.
`credit.rollover_forfeited`	Les crédits sont perdus, car le nombre maximal de reports a été atteint.
`credit.overage_charged`	Des frais de dépassement sont appliqués pour une utilisation au-delà d’un solde nul.
`credit.overage_reset`	Les frais de dépassement cumulés sont réinitialisés (par exemple, au début d’un nouveau cycle de facturation).
`credit.manual_adjustment`	Un ajustement manuel de crédit ou de débit est effectué.
`credit.balance_low`	Le solde de crédits passe sous le seuil configuré.

Pour consulter les schémas de payload détaillés et des exemples de handlers, reportez-vous à Webhooks de facturation basée sur les crédits.

Événements de récupération

Événement	Se déclenche lorsque
`abandoned_checkout.detected`	Un checkout incomplet ou échoué est détecté après 60 minutes.
`abandoned_checkout.recovered`	Un client effectue un paiement via un lien de récupération.

Pour consulter les schémas de payload détaillés, les descriptions des champs et des exemples de handlers, reportez-vous à Webhooks de récupération.

Événements de relance de paiement

Événement	Se déclenche lorsque
`dunning.started`	Une tentative de relance commence pour un abonnement dont le paiement est en retard ou qui est en pause, ou qui a été annulé.
`dunning.recovered`	Un client met à jour son moyen de paiement et le prélèvement qui en résulte est réussi.

Pour consulter les schémas de payload détaillés, les descriptions des champs et des exemples de handlers, reportez-vous à Webhooks de récupération.

Événements de versement

Les événements de versement suivent le transfert de vos fonds de Dodo Payments vers votre compte bancaire. Ils correspondent aux statuts des versements affichés dans le dashboard. Le payload est un objet de versement ayant la même structure qu’une entrée de GET /payouts.

Événement	Se déclenche lorsque
`payout.created`	Un versement est créé, soit par le cycle de versement automatique, soit en dehors du cycle.
`payout.in_progress`	La date d’échéance du versement arrive et le traitement commence.
`payout.on_hold`	Un versement est mis en pause ou placé sous examen.
`payout.success`	Le versement sur votre compte bancaire est réglé.
`payout.failed`	Un versement échoue. Les fonds et les frais sont recrédités sur votre portefeuille.

Les événements de versement ne sont ni terminaux ni strictement ordonnés. payout.failed peut arriver après payout.success lorsqu’une banque retourne le transfert, et payout.success peut arriver après payout.failed lorsqu’un versement échoué est ensuite récupéré. Le status du payload correspond toujours au type d’événement ; utilisez donc le timestamp de niveau supérieur de chaque événement pour trouver l’état le plus récent.

payout.created était auparavant émis sous la forme payout.not_initiated. Si un endpoint existant applique un filtre sur payout.not_initiated, mettez à jour le filtre pour utiliser payout.created afin qu’il continue de fonctionner.

Pour consulter les schémas de payload détaillés, les descriptions des champs et des exemples de handlers, reportez-vous à Webhooks de versement.

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 récupération

Événements de relance de paiement

É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 récupération

​Événements de relance de paiement

​É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 récupération

Événements de relance de paiement

Événements de versement