Webhook Payloads
Webhook chi trả
Payload được gửi đến webhook endpoint của bạn khi một khoản chi trả được tạo hoặc thay đổi trạng thái. Sử dụng các sự kiện này để đối soát các khoản chi trả trong hệ thống kế toán của bạn.
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
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, chargebacks và tax 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
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 Lần sửa đổi cuối 26 tháng 9, 2026