Skip to main content
I webhook dei pagamenti ti informano quando i tuoi fondi vengono trasferiti da Dodo Payments al tuo conto bancario. Usali per riconciliare i pagamenti nei tuoi sistemi contabili senza eseguire il polling dell’endpoint List Payouts.

Eventi webhook dei pagamenti

Un pagamento genera un evento in ogni fase del suo ciclo di vita. Le fasi corrispondono agli stati dei pagamenti mostrati nella dashboard.
payout.created veniva precedentemente generato come payout.not_initiated. Se un endpoint esistente applica un filtro su payout.not_initiated, aggiorna il filtro a payout.created affinché continui a trovare le corrispondenze. Il campo status del payload riporta ancora not_initiated in questa fase.

Gestione degli eventi dei pagamenti

I pagamenti riguardano il tuo denaro, non quello di un cliente, quindi questi eventi alimentano solitamente la contabilità e gli avvisi interni, anziché flussi rivolti ai clienti.
Handling payout events
Verifica sempre la firma del webhook prima dell’elaborazione — consulta la guida Webhooks per la configurazione. Il gestore riportato sopra omette la verifica per brevità.
Gli eventi dei pagamenti non sono né terminali né strettamente ordinati. payout.failed può arrivare dopo payout.success quando una banca restituisce il trasferimento, mentre payout.success può arrivare dopo payout.failed quando un pagamento non riuscito viene successivamente recuperato. Considera il campo status del payload come lo stato corrente, invece di presumere che l’ultimo evento ricevuto sia definitivo.

Stato del pagamento

L’oggetto del pagamento riporta il proprio avanzamento tramite un singolo campo:
refunds, chargebacks e tax nel payload sono deprecati. Usa gli endpoint per il dettaglio del pagamento per una suddivisione dettagliata.

Correlati

Payout Structure

Come vengono programmati e calcolati i pagamenti e cosa significa ogni stato del pagamento.

Balances & Wallets

Monitora i saldi del wallet e il registro alla base di ogni pagamento.

Schema del payload del webhook

amount
integer<int64>
obbligatorio

The total amount of the payout.

business_id
string
obbligatorio

The unique identifier of the business associated with the payout.

chargebacks
integer<int64>
obbligatorio
deprecato

The total value of chargebacks associated with the payout.

created_at
string<date-time>
obbligatorio

The timestamp when the payout was created, in UTC.

currency
enum<string>
obbligatorio

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

Opzioni disponibili:
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>
obbligatorio

The fee charged for processing the payout.

payment_method
string
obbligatorio

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

payout_id
string
obbligatorio

The unique identifier of the payout.

refunds
integer<int64>
obbligatorio
deprecato

The total value of refunds associated with the payout.

status
enum<string>
obbligatorio

The current status of the payout.

Opzioni disponibili:
not_initiated,
in_progress,
on_hold,
failed,
success
tax
integer<int64>
obbligatorio
deprecato

The tax applied to the payout.

updated_at
string<date-time>
obbligatorio

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.

Ultima modifica il 6 agosto 2026