Zum Hauptinhalt springen
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

EreignisnameEreignistypBeschreibung
Payment Succeededpayment.succeededWird ausgelöst, wenn eine Zahlung erfolgreich verarbeitet wurde.
Payment Failedpayment.failedTritt auf, wenn ein Zahlungsversuch aufgrund von Fehlern, abgelehnten Karten oder anderen Problemen fehlschlägt.
Payment Processingpayment.processingZeigt an, dass eine Zahlung derzeit verarbeitet wird.
Payment Cancelledpayment.cancelledWird ausgelöst, wenn eine Zahlung vor Abschluss storniert wird.

Rückerstattungsevents

EreignisnameEreignistypBeschreibung
Refund Succeededrefund.succeededWird ausgelöst, wenn eine Rückerstattung erfolgreich verarbeitet wurde.
Refund Failedrefund.failedTritt auf, wenn ein Rückerstattungsversuch aufgrund von Verarbeitungsfehlern oder anderen Problemen fehlschlägt.

Streitigkeitsevents

EreignisnameEreignistypBeschreibung
Dispute Openeddispute.openedWird ausgelöst, wenn ein Kunde einen Streitfall eröffnet.
Dispute Expireddispute.expiredZeigt an, dass ein Streitfall ohne Lösung abgelaufen ist.
Dispute Accepteddispute.acceptedWird ausgelöst, wenn ein Händler den Streitfall akzeptiert.
Dispute Cancelleddispute.cancelledTritt auf, wenn ein Streitfall vom Kunden oder System storniert wird.
Dispute Challengeddispute.challengedWird ausgelöst, wenn ein Händler einen Streitfall anfechtet.
Dispute Wondispute.wonZeigt an, dass der Händler einen Streitfall erfolgreich gewonnen hat.
Dispute Lostdispute.lostTritt auf, wenn der Händler einen Streitfall verliert.

Abonnementsevents

EreignisnameEreignistypBeschreibung
Subscription Activesubscription.activeZeigt an, dass ein Abonnement nun aktiv ist und wiederkehrende Gebühren geplant sind.
Subscription Updatedsubscription.updatedWird ausgelöst, wenn ein beliebiges Abonnementfeld aktualisiert wird (Echtzeit-Synchronisation ohne Polling).
Subscription On Holdsubscription.on_holdWird ausgelöst, wenn ein Abonnement aufgrund einer fehlgeschlagenen Verlängerung vorübergehend pausiert wird.
Subscription Renewedsubscription.renewedTritt auf, wenn ein Abonnement erfolgreich verlängert wird.
Subscription Plan Changedsubscription.plan_changedWird ausgelöst, wenn ein Abonnement hochgestuft, herabgestuft oder mit anderen Add-ons geändert wird.
Subscription Cancelledsubscription.cancelledWird ausgelöst, wenn ein Abonnement vom Händler oder Kunden gekündigt wird.
Subscription Failedsubscription.failedGibt ein fehlgeschlagenes Abonnement an. Das bedeutet, dass wir kein Mandat erstellen konnten.
Subscription Expiredsubscription.expiredWird ausgelöst, wenn ein Abonnement das Ende seiner Laufzeit erreicht und ausläuft.

Lizenzschlüsselereignisse

EreignisnameEreignistypBeschreibung
License Key Createdlicense_key.createdWird ausgelöst, wenn ein neuer Lizenzschlüssel für ein Produkt erstellt wird.

Credit Events

Event NameEvent TypeBeschreibung
Credit Addedcredit.addedWird ausgelöst, wenn Credits einem Kunden gutgeschrieben werden (Abonnement, Einzelzahlung, Add-on oder API).
Credit Deductedcredit.deductedTritt auf, wenn Credits durch Nutzung oder manuelle Belastung verbraucht werden.
Credit Expiredcredit.expiredWird ausgelöst, wenn ungenutzte Credits nach Ablauf des konfigurierten Verfallszeitraums verfallen.
Credit Rolled Overcredit.rolled_overTritt auf, wenn ungenutzte Credits am Ende eines Zyklus in eine neue Gutschrift übernommen werden.
Rollover Forfeitedcredit.rollover_forfeitedWird ausgelöst, wenn Credits verfallen, weil die maximale Anzahl an Übertragungen erreicht wurde.
Overage Chargedcredit.overage_chargedTritt auf, wenn Überziehungsgebühren für Nutzung über das Guthaben hinaus erhoben werden.
Manual Adjustmentcredit.manual_adjustmentWird ausgelöst, wenn eine manuelle Gutschrift- oder Belastungsanpassung vorgenommen wird.
Balance Lowcredit.balance_lowWird ausgelöst, wenn das Guthaben unter den konfigurierten Schwellenwert fällt.
Diese Webhook-Ereignisse sollen Händlern kritische Aktualisierungen liefern, damit sie ihre Abläufe effizient verwalten können. Implementieren Sie robuste Handler für jedes relevante Ereignis in Ihrer Webhook-Integration, um eine reibungslose und zuverlässige Funktionalität sicherzustellen.