Skip to main content
Os webhooks de repasse informam quando seus próprios fundos são transferidos da Dodo Payments para sua conta bancária. Use-os para reconciliar repasses em seus sistemas contábeis sem consultar repetidamente o endpoint List Payouts.

Eventos de webhook de repasse

Um repasse emite um evento em cada etapa do seu ciclo de vida. As etapas correspondem aos status de repasse exibidos no seu dashboard.
O payout.created era emitido anteriormente como payout.not_initiated. Se um endpoint existente filtra por payout.not_initiated, atualize o filtro para payout.created para que ele continue correspondendo. O campo status no payload ainda informa not_initiated nesta etapa.

Como lidar com eventos de repasse

Os repasses dizem respeito ao seu próprio dinheiro, e não ao de um cliente, portanto esses eventos geralmente alimentam a escrituração contábil e os alertas internos, em vez de fluxos voltados para o cliente.
Handling payout events
Sempre verifique a assinatura do webhook antes do processamento — consulte o guia de Webhooks para obter instruções de configuração. O handler acima omite a verificação por brevidade.
Os eventos de repasse não são terminais nem seguem uma ordem estrita. payout.failed pode chegar depois de payout.success quando um banco devolve a transferência, e payout.success pode chegar depois de payout.failed quando um repasse com falha é recuperado posteriormente. Considere o campo status no payload como o estado atual, em vez de presumir que o último evento recebido é definitivo.

Status do repasse

O objeto de repasse informa seu progresso por meio de um único campo:
refunds, chargebacks e tax no payload estão obsoletos. Use os endpoints de detalhamento de repasse para obter um detalhamento completo.

Relacionado

Payout Structure

Como os repasses são programados e calculados, e o que cada status de repasse significa.

Balances & Wallets

Acompanhe os saldos da carteira e o ledger por trás de cada repasse.

Esquema do payload do webhook

amount
integer<int64>
obrigatório

The total amount of the payout.

business_id
string
obrigatório

The unique identifier of the business associated with the payout.

chargebacks
integer<int64>
obrigatório
obsoleto

The total value of chargebacks associated with the payout.

created_at
string<date-time>
obrigatório

The timestamp when the payout was created, in UTC.

currency
enum<string>
obrigatório

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

Opções disponíveis:
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>
obrigatório

The fee charged for processing the payout.

payment_method
string
obrigatório

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

payout_id
string
obrigatório

The unique identifier of the payout.

refunds
integer<int64>
obrigatório
obsoleto

The total value of refunds associated with the payout.

status
enum<string>
obrigatório

The current status of the payout.

Opções disponíveis:
not_initiated,
in_progress,
on_hold,
failed,
success
tax
integer<int64>
obrigatório
obsoleto

The tax applied to the payout.

updated_at
string<date-time>
obrigatório

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 modificação em 6 de agosto de 2026