Skip to main content
Dodo Payments cung cấp thông báo webhook theo thời gian thực để giữ cho bạn được thông báo về các sự kiện quan trọng liên quan đến giao dịch, đăng ký, hoàn tiền, tranh chấp và quản lý khóa bản quyền. Dưới đây là hướng dẫn chi tiết về các sự kiện này, được phân loại để dễ hiểu, cùng với các mẹo và cân nhắc khi triển khai.

Sự Kiện Thanh Toán

Sự Kiện Hoàn Tiền

Sự Kiện Tranh Chấp

Sự Kiện Đăng Ký

Sự Kiện Khóa Bản Quyền

Các Sự Kiện Cấp Quyền

Để biết chi tiết về các lược đồ tải trọng, sự kiện mẫu và tham chiếu đầy đủ revocation_reason, xem Webhook Cấp Quyền.

Các Sự Kiện Tín Dụng

Các Sự Kiện Khôi Phục

Để biết chi tiết về lược đồ payload, mô tả trường, và ví dụ về xử lý, xem Recovery Webhooks.

Các Sự Kiện Dunning

Để biết chi tiết về các lược đồ tải trọng, mô tả trường và ví dụ về trình xử lý, xem Webhook Khôi Phục.

Sự kiện Payout

Các sự kiện này theo dõi quá trình chuyển tiền của bạn từ Dodo Payments đến tài khoản ngân hàng, phản ánh trạng thái payout được hiển thị trong dashboard. Payload là một đối tượng payout có cùng cấu trúc với một mục nhập từ GET /payouts.
Không được giả định rằng các sự kiện payout là trạng thái kết thúc hoặc luôn xuất hiện theo đúng thứ tự. payout.failed có thể xuất hiện hợp lệ sau payout.success khi ngân hàng hoàn trả giao dịch chuyển tiền, và payout.success có thể xuất hiện sau payout.failed khi một payout không thành công được khôi phục sau đó. Luôn coi trạng thái trong payload là trạng thái hiện tại.
payout.created trước đây được phát hành dưới dạng payout.not_initiated. Nếu bạn có endpoint hiện tại đ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.
Để xem schema payload chi tiết, mô tả trường và ví dụ về handler, hãy tham khảo Payout Webhooks. Các sự kiện webhook này được thiết kế để cung cấp cho merchant những cập nhật quan trọng nhằm quản lý hoạt động một cách hiệu quả. Hãy triển khai các handler mạnh mẽ cho từng sự kiện liên quan trong quá trình tích hợp webhook để đảm bảo chức năng hoạt động trơn tru và đáng tin cậy.
Lần sửa đổi cuối 17 tháng 8, 2026