Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
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. |
Ereignisse der Berechtigungsvergabe
| Ereignisname | Ereignistyp | Beschreibung |
|---|
| Grant Created | entitlement_grant.created | Eine neue Berechtigungsvergabe wird für einen Kunden erstellt. Lizenzschlüssel-Zuweisungen erfolgen delivered; OAuth-basierte Zuweisungen (Discord, GitHub, Notion) erfolgen pending. |
| Grant Delivered | entitlement_grant.delivered | Die Erfüllung der Zuweisung ist abgeschlossen—Lizenzschlüssel ausgestellt, Dateilinks aufgelöst oder Plattformzugang gewährt. |
| Grant Failed | entitlement_grant.failed | Die Erfüllung der Zuweisung ist fehlgeschlagen; untersuchen Sie error_code und error_message. |
| Grant Revoked | entitlement_grant.revoked | Der Zugang wurde entzogen; untersuchen Sie revocation_reason (Abonnementzustand, Rückerstattung, Planänderung oder manuell). |
revocation_reason-Referenz siehe Webhook zur Berechtigungsvergabe.
Guthaben-Ereignisse
| Ereignisname | Ereignistyp | Beschreibung |
|---|
| Credit Added | credit.added | Ausgelöst, wenn einem Kunden Guthaben gewährt wird (Abonnement, einmalig, Add-on oder API). |
| Credit Deducted | credit.deducted | Tritt auf, wenn Guthaben durch Nutzung oder manuelle Abbuchung verbraucht wird. |
| Credit Expired | credit.expired | Ausgelöst, wenn ungenutzte Guthaben nach der konfigurierten Ablaufzeit verfallen. |
| Credit Rolled Over | credit.rolled_over | Tritt auf, wenn ungenutzte Guthaben am Ende eines Zyklus auf eine neue Zuweisung übertragen werden. |
| Rollover Forfeited | credit.rollover_forfeited | Ausgelöst, wenn Guthaben verfallen, weil die maximale Rollback-Anzahl erreicht wurde. |
| Overage Charged | credit.overage_charged | Tritt auf, wenn Überziehungsgebühren für die Nutzung über den Nullsaldo hinaus erhoben werden. |
| Manual Adjustment | credit.manual_adjustment | Ausgelöst, wenn eine manuelle Guthaben- oder Abbuchungsanpassung vorgenommen wird. |
| Balance Low | credit.balance_low | Ausgelöst, wenn der Guthabenstand unter den konfigurierten Schwellenwert fällt. |
Wiederherstellungsereignisse
| Ereignisname | Ereignistyp | Beschreibung |
|---|
| Abandoned Checkout Detected | abandoned_checkout.detected | Ausgelöst, wenn ein unvollständiger oder fehlgeschlagener Checkout nach 60 Minuten erkannt wird. |
| Abandoned Checkout Recovered | abandoned_checkout.recovered | Tritt auf, wenn ein Kunde die Zahlung über einen Wiederherstellungslink abschließt. |
Mahnwesen-Ereignisse
| Ereignisname | Ereignistyp | Beschreibung |
|---|
| Dunning Started | dunning.started | Ausgelöst, wenn ein Mahnversuch für ein Abonnement beginnt, das pausiert oder storniert wurde. |
| Dunning Recovered | dunning.recovered | Tritt auf, wenn ein Kunde seine Zahlungsmethode aktualisiert und die resultierende Abbuchung erfolgreich ist. |
