Skip to main content
Les webhooks de versement vous indiquent quand vos propres fonds sont transférés de Dodo Payments vers votre compte bancaire. Utilisez-les pour rapprocher les versements dans vos systèmes comptables sans interroger l’endpoint List Payouts.

Événements webhook de versement

Un versement émet un événement à chaque étape de son cycle de vie. Les étapes correspondent aux statuts des versements affichés dans votre tableau de bord.
payout.created était précédemment émis sous le nom payout.not_initiated. Si un endpoint existant utilise un filtre sur payout.not_initiated, mettez à jour le filtre vers payout.created afin qu’il continue de fonctionner. Le champ status de la charge utile indique toujours not_initiated à cette étape.

Gestion des événements de versement

Les versements concernent votre propre argent plutôt que celui d’un client. Ces événements alimentent donc généralement la comptabilité et les alertes internes, plutôt que des flux destinés aux clients.
Handling payout events
Vérifiez toujours la signature du webhook avant le traitement — consultez le guide Webhooks pour la configuration. Le gestionnaire ci-dessus omet la vérification par souci de concision.
Les événements de versement ne sont ni définitifs ni strictement ordonnés. payout.failed peut arriver après payout.success lorsqu’une banque retourne le transfert, et payout.success peut arriver après payout.failed lorsqu’un versement ayant échoué est ensuite récupéré. Considérez le champ status de la charge utile comme l’état actuel, plutôt que de supposer que le dernier événement reçu est définitif.

Statut du versement

L’objet de versement indique sa progression au moyen d’un seul champ :
refunds, chargebacks et tax de la charge utile sont obsolètes. Utilisez plutôt les endpoints de ventilation des versements pour obtenir une ventilation détaillée.

Voir aussi

Payout Structure

Comment les versements sont planifiés et calculés, et ce que signifie chaque statut de versement.

Balances & Wallets

Suivez les soldes du portefeuille et le registre derrière chaque versement.

Schéma de la charge utile du webhook

amount
integer<int64>
requis

The total amount of the payout.

business_id
string
requis

The unique identifier of the business associated with the payout.

chargebacks
integer<int64>
requis
obsolète

The total value of chargebacks associated with the payout.

created_at
string<date-time>
requis

The timestamp when the payout was created, in UTC.

currency
enum<string>
requis

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

Options 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>
requis

The fee charged for processing the payout.

payment_method
string
requis

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

payout_id
string
requis

The unique identifier of the payout.

refunds
integer<int64>
requis
obsolète

The total value of refunds associated with the payout.

status
enum<string>
requis

The current status of the payout.

Options disponibles:
not_initiated,
in_progress,
on_hold,
failed,
success
tax
integer<int64>
requis
obsolète

The tax applied to the payout.

updated_at
string<date-time>
requis

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.

Dernière modification le 6 août 2026