Skip to main content
Los webhooks de payout te indican cuándo tus propios fondos se transfieren de Dodo Payments a tu cuenta bancaria. Úsalos para conciliar los payouts en tus sistemas contables sin consultar periódicamente el endpoint List Payouts.

Eventos de webhook de payout

Un payout emite un evento en cada etapa de su ciclo de vida. Las etapas coinciden con los estados de payout que se muestran en tu dashboard.
payout.created se emitía anteriormente como payout.not_initiated. Si un endpoint existente filtra por payout.not_initiated, actualiza el filtro a payout.created para que siga coincidiendo. El campo status del payload sigue indicando not_initiated en esta etapa.

Gestión de eventos de payout

Los payouts corresponden a tu propio dinero, no al de un cliente, por lo que estos eventos normalmente alimentan la contabilidad y las alertas internas, en lugar de los flujos orientados al cliente.
Handling payout events
Verifica siempre la firma del webhook antes de procesarlo; consulta la guía de Webhooks para configurarla. El handler anterior omite la verificación para simplificar.
Los eventos de payout no son terminales ni siguen un orden estricto. payout.failed puede llegar después de payout.success cuando un banco devuelve la transferencia, y payout.success puede llegar después de payout.failed cuando un payout fallido se recupera posteriormente. Trata el campo status del payload como el estado actual, en lugar de asumir que el último evento recibido es definitivo.

Estado del payout

El objeto payout informa de su progreso mediante un único campo:
refunds, chargebacks e tax del payload están obsoletos. Usa los endpoints de desglose de payouts para obtener un desglose detallado.

Relacionado

Payout Structure

Cómo se programan y calculan los payouts, y qué significa cada estado de payout.

Balances & Wallets

Haz un seguimiento de los saldos de la wallet y del ledger que respalda cada payout.

Esquema del payload del webhook

amount
integer<int64>
requerido

The total amount of the payout.

business_id
string
requerido

The unique identifier of the business associated with the payout.

chargebacks
integer<int64>
requerido
obsoleto

The total value of chargebacks associated with the payout.

created_at
string<date-time>
requerido

The timestamp when the payout was created, in UTC.

currency
enum<string>
requerido

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

Opciones disponibles:
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>
requerido

The fee charged for processing the payout.

payment_method
string
requerido

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

payout_id
string
requerido

The unique identifier of the payout.

refunds
integer<int64>
requerido
obsoleto

The total value of refunds associated with the payout.

status
enum<string>
requerido

The current status of the payout.

Opciones disponibles:
not_initiated,
in_progress,
on_hold,
failed,
success
tax
integer<int64>
requerido
obsoleto

The tax applied to the payout.

updated_at
string<date-time>
requerido

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.

Última modificación el 6 de agosto de 2026