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.