Webhooks
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.
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.
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. |