Dodo Payments bietet Echtzeit-Webhooks-Benachrichtigungen, um Sie über kritische Ereignisse im Zusammenhang mit Transaktionen, Abonnements, Rückerstattungen, Streitigkeiten und der Verwaltung von Lizenzschlüsseln zu informieren. Im Folgenden finden Sie einen detaillierten Leitfaden zu diesen Ereignissen, die zur Klarheit kategorisiert sind, sowie Implementierungstipps und -überlegungen.
Zahlungsevents
| Ereignisname | Ereignistyp | Beschreibung |
|---|
| Payment Succeeded | payment.succeeded | Wird ausgelöst, wenn eine Zahlung erfolgreich verarbeitet wurde. |
| Payment Failed | payment.failed | Tritt auf, wenn ein Zahlungsversuch aufgrund von Fehlern, abgelehnten Karten oder anderen Problemen fehlschlägt. |
| Payment Processing | payment.processing | Zeigt an, dass eine Zahlung derzeit verarbeitet wird. |
| Payment Cancelled | payment.cancelled | Wird ausgelöst, wenn eine Zahlung vor Abschluss storniert wird. |
Rückerstattungsevents
| Ereignisname | Ereignistyp | Beschreibung |
|---|
| Refund Succeeded | refund.succeeded | Wird ausgelöst, wenn eine Rückerstattung erfolgreich verarbeitet wurde. |
| Refund Failed | refund.failed | Tritt auf, wenn ein Rückerstattungsversuch aufgrund von Verarbeitungsfehlern oder anderen Problemen fehlschlägt. |
Streitigkeitsevents
| Ereignisname | Ereignistyp | Beschreibung |
|---|
| Dispute Opened | dispute.opened | Wird ausgelöst, wenn ein Kunde einen Streitfall eröffnet. |
| Dispute Expired | dispute.expired | Zeigt an, dass ein Streitfall ohne Lösung abgelaufen ist. |
| Dispute Accepted | dispute.accepted | Wird ausgelöst, wenn ein Händler den Streitfall akzeptiert. |
| Dispute Cancelled | dispute.cancelled | Tritt auf, wenn ein Streitfall vom Kunden oder System storniert wird. |
| Dispute Challenged | dispute.challenged | Wird ausgelöst, wenn ein Händler einen Streitfall anfechtet. |
| Dispute Won | dispute.won | Zeigt an, dass der Händler einen Streitfall erfolgreich gewonnen hat. |
| Dispute Lost | dispute.lost | Tritt auf, wenn der Händler einen Streitfall verliert. |
Abonnementsevents
| Ereignisname | Ereignistyp | Beschreibung |
|---|
| Subscription Active | subscription.active | Zeigt an, dass ein Abonnement nun aktiv ist und wiederkehrende Gebühren geplant sind. |
| Subscription Updated | subscription.updated | Wird ausgelöst, wenn ein beliebiges Abonnementfeld aktualisiert wird (Echtzeit-Synchronisation ohne Polling). |
| Subscription On Hold | subscription.on_hold | Wird ausgelöst, wenn ein Abonnement aufgrund einer fehlgeschlagenen Verlängerung vorübergehend pausiert wird. |
| Subscription Renewed | subscription.renewed | Tritt auf, wenn ein Abonnement erfolgreich verlängert wird. |
| Subscription Plan Changed | subscription.plan_changed | Wird ausgelöst, wenn ein Abonnement hochgestuft, herabgestuft oder mit anderen Add-ons geändert wird. |
| Subscription Cancelled | subscription.cancelled | Wird ausgelöst, wenn ein Abonnement vom Händler oder Kunden gekündigt wird. |
| Subscription Failed | subscription.failed | Gibt ein fehlgeschlagenes Abonnement an. Das bedeutet, dass wir kein Mandat erstellen konnten. |
| Subscription Expired | subscription.expired | Wird ausgelöst, wenn ein Abonnement das Ende seiner Laufzeit erreicht und ausläuft. |
Lizenzschlüsselereignisse
| Ereignisname | Ereignistyp | Beschreibung |
|---|
| License Key Created | license_key.created | Wird ausgelöst, wenn ein neuer Lizenzschlüssel für ein Produkt erstellt wird. |
Credit Events
| Event Name | Event Type | Beschreibung |
|---|
| Credit Added | credit.added | Wird ausgelöst, wenn Credits einem Kunden gutgeschrieben werden (Abonnement, Einzelzahlung, Add-on oder API). |
| Credit Deducted | credit.deducted | Tritt auf, wenn Credits durch Nutzung oder manuelle Belastung verbraucht werden. |
| Credit Expired | credit.expired | Wird ausgelöst, wenn ungenutzte Credits nach Ablauf des konfigurierten Verfallszeitraums verfallen. |
| Credit Rolled Over | credit.rolled_over | Tritt auf, wenn ungenutzte Credits am Ende eines Zyklus in eine neue Gutschrift übernommen werden. |
| Rollover Forfeited | credit.rollover_forfeited | Wird ausgelöst, wenn Credits verfallen, weil die maximale Anzahl an Übertragungen erreicht wurde. |
| Overage Charged | credit.overage_charged | Tritt auf, wenn Überziehungsgebühren für Nutzung über das Guthaben hinaus erhoben werden. |
| Manual Adjustment | credit.manual_adjustment | Wird ausgelöst, wenn eine manuelle Gutschrift- oder Belastungsanpassung vorgenommen wird. |
| Balance Low | credit.balance_low | Wird ausgelöst, wenn das Guthaben unter den konfigurierten Schwellenwert fällt. |
Last modified on March 2, 2026
