Webhook Payloads
Webhook Tranh chấp
Dữ liệu được gửi đến endpoint Webhook của bạn khi một tranh chấp được tạo hoặc cập nhật. Xử lý từng sự kiện để phản hồi tranh chấp và đối soát bản ghi của bạn.
Là Merchant of Record của bạn, Dodo Payments quản lý quy trình tranh chấp và hoàn tiền với mạng lưới thẻ thay mặt cho bạn. Những webhook này giữ cho hệ thống của bạn đồng bộ khi một tranh chấp di chuyển qua vòng đời của nó để bạn có thể thu hồi quyền truy cập, thu thập bằng chứng và đối chiếu hồ sơ của mình.
Các Sự Kiện Webhook Tranh Chấp
Một tranh chấp phát đi một sự kiện ở mỗi giai đoạn của vòng đời của nó:Các tranh chấp tự động giải quyết thông qua Visa Rapid Dispute Resolution (RDR) xuất hiện dưới dạng
dispute.lost với is_resolved_by_rdr: true. Điều này được mong đợi — việc hoàn tiền được thực hiện tự động để ngăn chặn một hoàn tiền chính thức.Ethoca alerts và deflections không bao giờ tạo tranh chấp, vì vậy chúng không phát ra sự kiện
dispute.* nào. Một khoản hoàn tiền từ Ethoca alert sẽ kích hoạt sự kiện refund.succeeded tiêu chuẩn, và mọi lượt hủy subscription được liên kết sẽ kích hoạt sự kiện subscription thông thường. Một deflection không kích hoạt sự kiện nào.Xử lý sự kiện tranh chấp
Khidispute.opened được kích hoạt, số tiền tranh chấp sẽ ngay lập tức được giữ lại. Sử dụng sự kiện này để cập nhật bản ghi của bạn và, nếu bạn định phản đối, thu thập bằng chứng trong dashboard.
Handling dispute events
Trạng thái và giai đoạn tranh chấp
Đối tượng tranh chấp báo cáo tiến trình của tranh chấp thông qua hai trường:Liên quan
Managing Disputes
Cách phản hồi tranh chấp, gửi bằng chứng và cách RDR bảo vệ tỷ lệ tranh chấp của bạn.
Handle Payment Failures
Phát hiện và khôi phục các khoản thanh toán thất bại trước khi chúng trở thành tranh chấp.
Schema dữ liệu Webhook
Lần sửa đổi cuối 26 tháng 9, 2026