Skip to main content
Payout webhook thông báo cho bạn khi tiền của chính bạn được chuyển từ Dodo Payments đến tài khoản ngân hàng. Sử dụng chúng để đối soát payout trong các hệ thống kế toán mà không cần polling endpoint List Payouts.

Các sự kiện Payout Webhook

Một payout phát sinh một sự kiện ở mỗi giai đoạn trong vòng đời. Các giai đoạn này tương ứng với trạng thái payout hiển thị trong dashboard của bạn.
payout.created trước đây được phát sinh dưới dạng payout.not_initiated. Nếu một endpoint hiện có đang lọc theo payout.not_initiated, hãy cập nhật bộ lọc thành payout.created để bộ lọc tiếp tục khớp. Trường status trong payload vẫn báo cáo not_initiated ở giai đoạn này.

Xử lý các sự kiện Payout

Payout liên quan đến tiền của chính bạn thay vì tiền của khách hàng, vì vậy các sự kiện này thường được dùng cho việc ghi sổ kế toán và cảnh báo nội bộ thay vì các flow hướng đến khách hàng.
Handling payout events
Luôn xác minh chữ ký webhook trước khi xử lý — xem hướng dẫn Webhooks để biết cách thiết lập. Handler ở trên lược bỏ bước xác minh để nội dung ngắn gọn hơn.
Các sự kiện payout không phải là terminal và cũng không nhất thiết được sắp xếp theo thứ tự. payout.failed có thể đến sau payout.success khi ngân hàng hoàn trả giao dịch chuyển tiền, và payout.success có thể đến sau payout.failed khi một payout không thành công sau đó được khôi phục. Hãy coi trường status trong payload là trạng thái hiện tại thay vì mặc định rằng sự kiện cuối cùng bạn nhận được là trạng thái cuối cùng.

Trạng thái Payout

Đối tượng payout báo cáo tiến trình của mình thông qua một trường duy nhất:
refunds, chargebackstax trong payload đã deprecated. Thay vào đó, hãy sử dụng payout breakup endpoints để xem phân tích chi tiết.

Liên quan

Payout Structure

Cách payout được lên lịch và tính toán, cùng ý nghĩa của từng trạng thái payout.

Balances & Wallets

Theo dõi số dư wallet và sổ cái phía sau từng payout.

Schema Payload Webhook

amount
integer<int64>
bắt buộc

The total amount of the payout.

business_id
string
bắt buộc

The unique identifier of the business associated with the payout.

chargebacks
integer<int64>
bắt buộc
không còn sử dụng

The total value of chargebacks associated with the payout.

created_at
string<date-time>
bắt buộc

The timestamp when the payout was created, in UTC.

currency
enum<string>
bắt buộc

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

Tùy chọn có sẵn:
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>
bắt buộc

The fee charged for processing the payout.

payment_method
string
bắt buộc

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

payout_id
string
bắt buộc

The unique identifier of the payout.

refunds
integer<int64>
bắt buộc
không còn sử dụng

The total value of refunds associated with the payout.

status
enum<string>
bắt buộc

The current status of the payout.

Tùy chọn có sẵn:
not_initiated,
in_progress,
on_hold,
failed,
success
tax
integer<int64>
bắt buộc
không còn sử dụng

The tax applied to the payout.

updated_at
string<date-time>
bắt buộc

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.

Lần sửa đổi cuối 6 tháng 8, 2026