Skip to main content
Auszahlungs- Webhooks informieren Sie darüber, wann Ihre eigenen Gelder von Dodo Payments auf Ihr Bankkonto überwiesen werden. Verwenden Sie sie, um Auszahlungen in Ihren Buchhaltungssystemen abzugleichen, ohne den Endpunkt Auszahlungen auflisten per Polling abzufragen.

Webhook-Ereignisse für Auszahlungen

Bei jeder Phase ihres Lebenszyklus löst eine Auszahlung ein Ereignis aus. Die Phasen entsprechen den Auszahlungsstatus in Ihrem Dashboard.
payout.created wurde zuvor als payout.not_initiated ausgelöst. Wenn ein bestehender Endpunkt nach payout.not_initiated filtert, aktualisieren Sie den Filter auf payout.created, damit er weiterhin passende Ergebnisse liefert. Das Feld status in den Daten meldet in dieser Phase weiterhin not_initiated.

Verarbeiten von Auszahlungsereignissen

Da es bei Auszahlungen um Ihr eigenes Geld und nicht um das eines Kunden geht, werden diese Ereignisse normalerweise in die Buchhaltung und interne Benachrichtigungen eingespeist und nicht in kundenorientierte Abläufe.
Handling payout events
Überprüfen Sie immer die Webhook-Signatur, bevor Sie die Verarbeitung durchführen — Informationen zur Einrichtung finden Sie im Webhooks-Leitfaden. Der obige Handler lässt die Überprüfung der Kürze halber aus.
Auszahlungsereignisse sind weder final noch streng 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. Behandeln Sie das Feld status in den Daten als den aktuellen Status, anstatt davon auszugehen, dass das zuletzt empfangene Ereignis endgültig ist.

Auszahlungsstatus

Das Auszahlungsobjekt meldet seinen Fortschritt über ein einzelnes Feld:
refunds, chargebacks und tax in den Daten sind veraltet. Verwenden Sie stattdessen die Endpunkte zur Aufschlüsselung von Auszahlungen, um eine detaillierte Aufschlüsselung zu erhalten.

Verwandte Themen

Payout Structure

Wie Auszahlungen geplant und berechnet werden und was die einzelnen Auszahlungsstatus bedeuten.

Balances & Wallets

Verfolgen Sie Wallet-Guthaben und das Ledger hinter jeder Auszahlung.

Schema der Webhook-Daten

amount
integer<int64>
erforderlich

The total amount of the payout.

business_id
string
erforderlich

The unique identifier of the business associated with the payout.

chargebacks
integer<int64>
erforderlich
veraltet

The total value of chargebacks associated with the payout.

created_at
string<date-time>
erforderlich

The timestamp when the payout was created, in UTC.

currency
enum<string>
erforderlich

The currency of the payout, represented as an ISO 4217 currency code.

Verfügbare Optionen:
AED,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BWP,
BYN,
BZD,
CAD,
CHF,
CLP,
CNY,
COP,
CRC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SEK,
SGD,
SHP,
SLE,
SLL,
SOS,
SRD,
SSP,
STN,
SVC,
SZL,
THB,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VES,
VND,
VUV,
WST,
XAF,
XCD,
XOF,
XPF,
YER,
ZAR,
ZMW
fee
integer<int64>
erforderlich

The fee charged for processing the payout.

payment_method
string
erforderlich

The payment method used for the payout (e.g., bank transfer, card, etc.).

payout_id
string
erforderlich

The unique identifier of the payout.

refunds
integer<int64>
erforderlich
veraltet

The total value of refunds associated with the payout.

status
enum<string>
erforderlich

The current status of the payout.

Verfügbare Optionen:
not_initiated,
in_progress,
on_hold,
failed,
success
tax
integer<int64>
erforderlich
veraltet

The tax applied to the payout.

updated_at
string<date-time>
erforderlich

The timestamp when the payout was last updated, in UTC.

name
string | null

The name of the payout recipient or purpose.

payout_document_url
string | null

The URL of the document associated with the payout.

remarks
string | null

Any additional remarks or notes associated with the payout.

Zuletzt geändert am 6. August 2026