Skip to main content
Webhook payout memberi tahu Anda saat dana Anda sendiri berpindah dari Dodo Payments ke rekening bank Anda. Gunakan webhook ini untuk merekonsiliasi payout dalam sistem akuntansi Anda tanpa melakukan polling pada endpoint List Payouts.

Event Webhook Payout

Sebuah payout menghasilkan event pada setiap tahap dalam siklus hidupnya. Tahapan tersebut sesuai dengan status payout yang ditampilkan di dashboard Anda.
payout.created sebelumnya dikirim sebagai payout.not_initiated. Jika endpoint yang sudah ada memfilter berdasarkan payout.not_initiated, perbarui filter tersebut ke payout.created agar tetap cocok. Field status pada payload tetap melaporkan not_initiated pada tahap ini.

Menangani Event Payout

Payout berkaitan dengan uang Anda sendiri, bukan uang pelanggan, sehingga event ini biasanya digunakan untuk pembukuan dan notifikasi internal, bukan untuk alur yang ditujukan kepada pelanggan.
Handling payout events
Selalu verifikasi signature webhook sebelum memprosesnya — lihat panduan Webhooks untuk penyiapan. Handler di atas menghilangkan verifikasi demi singkatnya contoh.
Event payout tidak selalu bersifat terminal dan tidak diurutkan secara ketat. payout.failed dapat tiba setelah payout.success ketika bank mengembalikan transfer, dan payout.success dapat tiba setelah payout.failed ketika payout yang gagal kemudian berhasil dipulihkan. Perlakukan field status pada payload sebagai status saat ini, bukan menganggap event terakhir yang Anda terima sebagai status final.

Status Payout

Objek payout melaporkan progresnya melalui satu field:
refunds, chargebacks, dan tax pada payload sudah deprecated. Gunakan endpoint payout breakup untuk rincian lengkap.

Terkait

Payout Structure

Cara payout dijadwalkan dan dihitung, serta arti setiap status payout.

Balances & Wallets

Pantau saldo wallet dan ledger di balik setiap payout.

Skema Payload Webhook

amount
integer<int64>
wajib

The total amount of the payout.

business_id
string
wajib

The unique identifier of the business associated with the payout.

chargebacks
integer<int64>
wajib
usang

The total value of chargebacks associated with the payout.

created_at
string<date-time>
wajib

The timestamp when the payout was created, in UTC.

currency
enum<string>
wajib

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

Opsi yang tersedia:
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>
wajib

The fee charged for processing the payout.

payment_method
string
wajib

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

payout_id
string
wajib

The unique identifier of the payout.

refunds
integer<int64>
wajib
usang

The total value of refunds associated with the payout.

status
enum<string>
wajib

The current status of the payout.

Opsi yang tersedia:
not_initiated,
in_progress,
on_hold,
failed,
success
tax
integer<int64>
wajib
usang

The tax applied to the payout.

updated_at
string<date-time>
wajib

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.

Terakhir diubah pada 6 Agustus 2026