Skip to main content
Webhooks för utbetalningar meddelar dig när dina egna medel överförs från Dodo Payments till ditt bankkonto. Använd dem för att stämma av utbetalningar i dina bokföringssystem utan att polla endpointen List Payouts.

Händelser för utbetalningar

En utbetalning genererar en händelse i varje steg av sin livscykel. Stegen motsvarar de statusar för utbetalningar som visas i din dashboard.
payout.created skickades tidigare som payout.not_initiated. Om en befintlig endpoint filtrerar på payout.not_initiated ska du uppdatera filtret till payout.created så att det fortsätter att matcha. Fältet status i nyttolasten rapporterar fortfarande not_initiated i detta skede.

Hantera händelser för utbetalningar

Utbetalningar gäller dina egna pengar snarare än en kunds, så dessa händelser används vanligtvis i bokföring och interna aviseringar i stället för i kundvända flöden.
Handling payout events
Verifiera alltid webhook-signaturen innan du behandlar den — se guiden om Webhooks för konfiguration. Hanteraren ovan utelämnar verifiering för korthetens skull.
Händelser för utbetalningar är varken slutgiltiga eller strikt ordnade. payout.failed kan komma efter payout.success när en bank returnerar överföringen, och payout.success kan komma efter payout.failed när en misslyckad utbetalning senare återställs. Använd fältet status i nyttolasten som det aktuella tillståndet i stället för att anta att den senaste händelsen du tog emot är slutgiltig.

Utbetalningsstatus

Utbetalningsobjektet rapporterar sina framsteg via ett enda fält:
refunds, chargebacks och tax i nyttolasten är föråldrade. Använd i stället endpoints för uppdelning av utbetalningar för en detaljerad uppdelning.

Relaterat

Payout Structure

Hur utbetalningar schemaläggs och beräknas, samt vad varje status för utbetalning innebär.

Balances & Wallets

Följ saldon i plånboken och huvudboken bakom varje utbetalning.

Schema för webhook-nyttolast

amount
integer<int64>
obligatorisk

The total amount of the payout.

business_id
string
obligatorisk

The unique identifier of the business associated with the payout.

chargebacks
integer<int64>
obligatorisk
föråldrad

The total value of chargebacks associated with the payout.

created_at
string<date-time>
obligatorisk

The timestamp when the payout was created, in UTC.

currency
enum<string>
obligatorisk

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

Tillgängliga alternativ:
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>
obligatorisk

The fee charged for processing the payout.

payment_method
string
obligatorisk

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

payout_id
string
obligatorisk

The unique identifier of the payout.

refunds
integer<int64>
obligatorisk
föråldrad

The total value of refunds associated with the payout.

status
enum<string>
obligatorisk

The current status of the payout.

Tillgängliga alternativ:
not_initiated,
in_progress,
on_hold,
failed,
success
tax
integer<int64>
obligatorisk
föråldrad

The tax applied to the payout.

updated_at
string<date-time>
obligatorisk

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.

Senast ändrad 6 augusti 2026