Webhook Event Guide

Understand the different webhook events triggered by Dodo Payments during payment, refund, subscription, dispute, and license key activities

Dodo Payments provides real-time webhook notifications to keep you informed about critical events related to transactions, subscriptions, refunds, disputes, and license key management. Below is a detailed guide to these events, categorized for clarity, along with implementation tips and considerations.

Payment Events

Event Name	Event Type	Description
Payment Succeeded	payment.succeeded	Triggered when a payment is successfully processed.
Payment Failed	payment.failed	Occurs when a payment attempt fails due to errors, declined cards, or other issues.
Payment Processing	payment.processing	Indicates that a payment is currently being processed.
Payment Cancelled	payment.cancelled	Triggered when a payment is cancelled before completion.

Refund Events

Event Name	Event Type	Description
Refund Succeeded	refund.succeeded	Triggered when a refund is successfully processed.
Refund Failed	refund.failed	Occurs when a refund attempt fails due to processing errors or other issues.

Dispute Events

Event Name	Event Type	Description
Dispute Opened	dispute.opened	Triggered when a customer initiates a dispute.
Dispute Expired	dispute.expired	Indicates that a dispute expired without resolution.
Dispute Accepted	dispute.accepted	Triggered when a merchant accepts the dispute.
Dispute Cancelled	dispute.cancelled	Occurs when a dispute is cancelled by the customer or system.
Dispute Challenged	dispute.challenged	Triggered when a merchant challenges a dispute.
Dispute Won	dispute.won	Indicates that the merchant has successfully won a dispute.
Dispute Lost	dispute.lost	Occurs when the merchant loses a dispute.

Subscription Events

Event Name	Event Type	Description
Subscription Active	subscription.active	Indicates that a subscription is now active and recurring charges are scheduled.
Subscription On Hold	subscription.on_hold	Triggered when a subscription is temporarily put on hold due to failed renewal.
Subscription Renewed	subscription.renewed	Occurs when a subscription is successfully renewed.
Subscription Plan Changed	subscription.plan_changed	Triggered when a subscription is upgraded, downgraded, or modified with different addons.
Subscription Cancelled	subscription.cancelled	Triggered when a subscription is cancelled by the merchant or customer.
Subscription Failed	subscription.failed	Indicates a failed subscription. This means that we were unable to create a mandate.
Subscription Expired	subscription.expired	Triggered when a subscription reaches the end of its term and expires.

License Key Events

Event Name	Event Type	Description
License Key Created	license_key.created	Triggered when a new license key is created for a product.

These webhook events are designed to provide merchants with critical updates to manage their operations effectively. Implement robust handlers for each relevant event in your webhook integration to ensure smooth and reliable functionality.