Passer au contenu principal
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 NameEvent TypeDescription
Payment Succeededpayment.succeededDéclenché lorsqu’un paiement est traité avec succès.
Payment Failedpayment.failedSe produit lorsqu’une tentative de paiement échoue en raison d’erreurs, de cartes refusées ou d’autres problèmes.
Payment Processingpayment.processingIndique qu’un paiement est en cours de traitement.
Payment Cancelledpayment.cancelledDéclenché lorsqu’un paiement est annulé avant son achèvement.

Événements de Remboursement

Event NameEvent TypeDescription
Refund Succeededrefund.succeededDéclenché lorsqu’un remboursement est traité avec succès.
Refund Failedrefund.failedSe produit lorsqu’une tentative de remboursement échoue en raison d’erreurs de traitement ou d’autres problèmes.

Événements de Litige

Event NameEvent TypeDescription
Dispute Openeddispute.openedDéclenché lorsqu’un client ouvre un litige.
Dispute Expireddispute.expiredIndique qu’un litige a expiré sans résolution.
Dispute Accepteddispute.acceptedDéclenché lorsqu’un commerçant accepte le litige.
Dispute Cancelleddispute.cancelledSe produit lorsqu’un litige est annulé par le client ou le système.
Dispute Challengeddispute.challengedDéclenché lorsqu’un commerçant conteste un litige.
Dispute Wondispute.wonIndique que le commerçant a remporté un litige.
Dispute Lostdispute.lostSe produit lorsque le commerçant perd un litige.

Événements d’Abonnement

Event NameEvent TypeDescription
Subscription Activesubscription.activeIndique qu’un abonnement est désormais actif et que des prélèvements récurrents sont planifiés.
Subscription Updatedsubscription.updatedDéclenché lorsqu’un champ d’abonnement est mis à jour (synchronisation en temps réel sans sondage).
Subscription On Holdsubscription.on_holdDéclenché lorsqu’un abonnement est temporairement suspendu en raison d’un échec de renouvellement.
Subscription Renewedsubscription.renewedSe produit lorsqu’un abonnement est renouvelé avec succès.
Subscription Plan Changedsubscription.plan_changedDéclenché lorsqu’un abonnement est amélioré, rétrogradé ou modifié avec différents modules complémentaires.
Subscription Cancelledsubscription.cancelledDéclenché lorsqu’un abonnement est annulé par le commerçant ou le client.
Subscription Failedsubscription.failedIndique un abonnement échoué. Cela signifie que nous n’avons pas pu créer un mandat.
Subscription Expiredsubscription.expiredDéclenché lorsqu’un abonnement arrive à la fin de son terme et expire.

Événements de Clé de Licence

Event NameEvent TypeDescription
License Key Createdlicense_key.createdDéclenché lorsqu’une nouvelle clé de licence est créée pour un produit.

Événements de crédit

Nom de l’événementType d’événementDescription
Credit Addedcredit.addedDéclenché lorsque des crédits sont accordés à un client (abonnement, unique, complément ou API).
Credit Deductedcredit.deductedSe produit lorsque des crédits sont consommés via l’utilisation ou un débit manuel.
Credit Expiredcredit.expiredDéclenché lorsque des crédits inutilisés expirent après la période d’expiration configurée.
Credit Rolled Overcredit.rolled_overSe produit lorsque des crédits inutilisés sont reportés vers une nouvelle attribution à la fin du cycle.
Rollover Forfeitedcredit.rollover_forfeitedDéclenché lorsque des crédits sont perdus parce que le nombre maximal de reports a été atteint.
Overage Chargedcredit.overage_chargedSe produit lorsque des frais de dépassement sont appliqués pour une utilisation au-delà du solde nul.
Manual Adjustmentcredit.manual_adjustmentDéclenché lorsqu’un ajustement manuel de crédit ou de débit est effectué.
Balance Lowcredit.balance_lowDéclenché lorsque le solde de crédits descend en dessous du seuil configuré.
Ces événements webhook sont conçus pour fournir aux marchands des mises à jour essentielles afin de gérer leurs opérations efficacement. Implémentez des gestionnaires robustes pour chaque événement pertinent dans votre intégration webhook afin d’assurer un fonctionnement fluide et fiable.