Leitfaden zu Webhook-Ereignissen

Dodo Payments löst in jeder Phase des Lebenszyklus einer Zahlung, eines Abonnements, einer Dispute, einer Auszahlung, eines Guthabens oder eines Lizenzschlüssels Webhook-Ereignisse aus. Diese Seite listet jedes Ereignis nach Ressource auf. Detaillierte Payload-Schemas und Beispiele für Handler finden Sie auf den unten verlinkten ressourcenspezifischen Seiten.

Zahlungsereignisse

Ereignis	Wird ausgelöst, wenn
`payment.succeeded`	Eine Zahlung erfolgreich verarbeitet wurde.
`payment.failed`	Ein Zahlungsversuch aufgrund abgelehnter Karten, unzureichender Deckung oder anderer Fehler fehlschlägt.
`payment.processing`	Eine Zahlung verarbeitet wird.
`payment.cancelled`	Eine Zahlung vor ihrem Abschluss storniert wird.

Das vollständige Payload-Schema finden Sie unter Payment Webhooks.

Rückerstattungsereignisse

Ereignis	Wird ausgelöst, wenn
`refund.succeeded`	Eine Rückerstattung erfolgreich verarbeitet wurde.
`refund.failed`	Ein Rückerstattungsversuch aufgrund von Verarbeitungsfehlern oder anderen Problemen fehlschlägt.

Das vollständige Payload-Schema finden Sie unter Refund Webhooks.

Dispute-Ereignisse

Ereignis	Wird ausgelöst, wenn
`dispute.opened`	Ein Karteninhaber eine Dispute zu einer Zahlung eröffnet.
`dispute.challenged`	Beweise zur Anfechtung der Dispute eingereicht wurden.
`dispute.accepted`	Die Dispute akzeptiert wurde, ohne angefochten zu werden.
`dispute.cancelled`	Die Dispute zurückgezogen oder storniert wurde.
`dispute.expired`	Das Antwortfenster ohne eine Lösung abgelaufen ist.
`dispute.won`	Die Dispute zu Ihren Gunsten entschieden wurde.
`dispute.lost`	Die Dispute zugunsten des Karteninhabers entschieden wurde.

Detaillierte Payload-Schemas und Beispiele für Handler finden Sie unter Dispute Webhooks.

Abonnementereignisse

Ereignis	Wird ausgelöst, wenn
`subscription.active`	Ein Abonnement erfolgreich aktiviert und wiederkehrende Abbuchungen geplant wurden.
`subscription.updated`	Sich ein beliebiges Feld des Abonnements ändert (Echtzeit-Synchronisierung ohne Polling).
`subscription.past_due`	Eine Verlängerung fehlschlägt und die Kulanzfrist beginnt; der Kunde behält bis zum Ablaufdatum Zugriff.
`subscription.on_hold`	Ein Abonnement aufgrund einer fehlgeschlagenen Verlängerung vorübergehend ausgesetzt wird.
`subscription.paused`	Ein Abonnement pausiert wird.
`subscription.unpaused`	Ein pausiertes Abonnement fortgesetzt wird.
`subscription.renewed`	Ein Abonnement erfolgreich für den nächsten Abrechnungszeitraum verlängert wurde.
`subscription.plan_changed`	Ein Abonnement hoch- oder herabgestuft oder mit anderen Add-ons geändert wird.
`subscription.update_payment_method`	Die Zahlungsmethode eines Abonnements aktualisiert wird.
`subscription.cancelled`	Ein Abonnement vom Händler oder Kunden gekündigt wird.
`subscription.failed`	Die Erstellung eines Abonnements während der Erstellung des Mandats fehlschlägt.
`subscription.expired`	Ein Abonnement das Ende seiner Laufzeit erreicht und abläuft.

Detaillierte Payload-Schemas und Beispiele für Handler finden Sie unter Subscription Webhooks.

Lizenzschlüsselereignisse

Ereignis	Wird ausgelöst, wenn
`license_key.created`	Ein neuer Lizenzschlüssel für ein Produkt erstellt wird.

Das vollständige Payload-Schema finden Sie unter License Key Webhooks.

Ereignisse zur Gewährung von Berechtigungen

Ereignis	Wird ausgelöst, wenn
`entitlement_grant.created`	Eine neue Berechtigungsgewährung für einen Kunden erstellt wird. Automatisch erfüllte Lizenzschlüsselgewährungen und Feature-Flag-Gewährungen werden mit `status: "Delivered"` ausgeliefert und lösen kein separates `delivered`-Ereignis aus. Andere Gewährungen, einschließlich manuell erfüllter Lizenzschlüssel, werden mit `Pending` ausgeliefert. Siehe Entitlement Grant.
`entitlement_grant.delivered`	Die Erfüllung der Gewährung abgeschlossen ist – der Lizenzschlüssel ausgestellt, Dateilinks aufgelöst oder Plattformzugriff gewährt wurde.
`entitlement_grant.failed`	Die Erfüllung der Gewährung fehlschlägt. Prüfen Sie `error_code` und `error_message` in der Payload.
`entitlement_grant.revoked`	Der Zugriff entzogen wird. Prüfen Sie `revocation_reason` in der Payload.

Detaillierte Payload-Schemas, Beispielereignisse und die vollständige Referenz für revocation_reason finden Sie unter Entitlement Grant Webhooks.

Guthabenereignisse

Ereignis	Wird ausgelöst, wenn
`credit.added`	Guthaben einem Kunden gewährt wird (über ein Abonnement, einen einmaligen Kauf, ein Add-on oder die API).
`credit.deducted`	Guthaben durch Nutzung oder eine manuelle Abbuchung verbraucht wird.
`credit.expired`	Nicht verwendetes Guthaben nach Ablauf des konfigurierten Ablaufszeitraums verfällt.
`credit.rolled_over`	Nicht verwendetes Guthaben am Ende eines Zyklus in eine neue Gewährung übertragen wird.
`credit.rollover_forfeited`	Guthaben verfällt, weil die maximale Anzahl an Übertragungen erreicht wurde.
`credit.overage_charged`	Aufpreise für eine Nutzung über ein Guthaben von null hinaus angewendet werden.
`credit.overage_reset`	Aufgelaufene Aufpreise zurückgesetzt werden (beispielsweise zu Beginn eines neuen Abrechnungszyklus).
`credit.manual_adjustment`	Eine manuelle Anpassung von Guthaben oder Abbuchungen vorgenommen wird.
`credit.balance_low`	Der Guthabenstand unter den konfigurierten Schwellenwert fällt.

Detaillierte Payload-Schemas und Beispiele für Handler finden Sie unter Credit-Based Billing Webhooks.

Wiederherstellungsereignisse

Ereignis	Wird ausgelöst, wenn
`abandoned_checkout.detected`	Nach 60 Minuten ein unvollständiger oder fehlgeschlagener Checkout erkannt wird.
`abandoned_checkout.recovered`	Ein Kunde die Zahlung über einen Wiederherstellungslink abschließt.

Detaillierte Payload-Schemas, Feldbeschreibungen und Beispiele für Handler finden Sie unter Recovery Webhooks.

Dunning-Ereignisse

Ereignis	Wird ausgelöst, wenn
`dunning.started`	Ein Dunning-Versuch für ein überfälliges, pausiertes oder gekündigtes Abonnement beginnt.
`dunning.recovered`	Ein Kunde seine Zahlungsmethode aktualisiert und die daraus resultierende Abbuchung erfolgreich ist.

Detaillierte Payload-Schemas, Feldbeschreibungen und Beispiele für Handler finden Sie unter Recovery Webhooks.

Auszahlungserignisse

Auszahlungsereignisse verfolgen, wie Ihre Gelder von Dodo Payments auf Ihr Bankkonto übertragen werden. Sie entsprechen den im Dashboard angezeigten Auszahlungsstatus. Die Payload ist ein Auszahlungsobjekt mit derselben Struktur wie ein Eintrag aus GET /payouts.

Ereignis	Wird ausgelöst, wenn
`payout.created`	Eine Auszahlung erstellt wird, entweder durch den automatischen Auszahlungszyklus oder außerhalb des Zyklus.
`payout.in_progress`	Das Fälligkeitsdatum der Auszahlung erreicht ist und die Verarbeitung beginnt.
`payout.on_hold`	Eine Auszahlung pausiert oder zur Prüfung zurückgestellt wird.
`payout.success`	Die Auszahlung auf Ihr Bankkonto verbucht wird.
`payout.failed`	Eine Auszahlung fehlschlägt. Das Geld und die Gebühren werden Ihrem Wallet wieder gutgeschrieben.

Auszahlungsereignisse sind weder abschließend noch strikt geordnet. payout.failed kann nach payout.success eintreffen, wenn eine Bank die Überweisung zurückgibt, und payout.success kann nach payout.failed eintreffen, wenn eine fehlgeschlagene Auszahlung später wiederhergestellt wird. Das status der Payload stimmt immer mit dem Ereignistyp überein. Verwenden Sie daher das übergeordnete timestamp jedes Ereignisses, um den neuesten Status zu ermitteln.

payout.created wurde zuvor als payout.not_initiated ausgelöst. Wenn ein bestehender Endpoint nach payout.not_initiated filtert, aktualisieren Sie den Filter auf payout.created, damit er weiterhin passende Ereignisse erfasst.

Detaillierte Payload-Schemas, Feldbeschreibungen und Beispiele für Handler finden Sie unter Payout Webhooks.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Zahlungsereignisse

Rückerstattungsereignisse

Dispute-Ereignisse

Abonnementereignisse

Lizenzschlüsselereignisse

Ereignisse zur Gewährung von Berechtigungen

Guthabenereignisse

Wiederherstellungsereignisse

Dunning-Ereignisse

Auszahlungserignisse

​Zahlungsereignisse

​Rückerstattungsereignisse

​Dispute-Ereignisse

​Abonnementereignisse

​Lizenzschlüsselereignisse

​Ereignisse zur Gewährung von Berechtigungen

​Guthabenereignisse

​Wiederherstellungsereignisse

​Dunning-Ereignisse

​Auszahlungserignisse

Zahlungsereignisse

Rückerstattungsereignisse

Dispute-Ereignisse

Abonnementereignisse

Lizenzschlüsselereignisse

Ereignisse zur Gewährung von Berechtigungen

Guthabenereignisse

Wiederherstellungsereignisse

Dunning-Ereignisse

Auszahlungserignisse