Skip to main content
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

Khi dispute.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
Luôn xác minh chữ ký Webhook trước khi xử lý — xem hướng dẫn Webhook để thiết lập. Handler ở trên lược bỏ bước xác minh để ngắn gọn.
Bạn có 10 ngày để phản hồi tranh chấp sau khi tranh chấp được tạo. Xem Các phương pháp hay nhất để phản hồi tranh chấp để biết những bằng chứng cần thu thập và cách định dạng bằng chứng.

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

amount
string
bắt buộc

The amount involved in the dispute, represented as a string to accommodate precision.

brand_id
string
bắt buộc

Brand id this dispute belongs to

business_id
string
bắt buộc

The unique identifier of the business involved in the dispute.

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

The timestamp of when the dispute was created, in UTC.

currency
string
bắt buộc

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

customer
object
bắt buộc

The customer who filed the dispute

dispute_id
string
bắt buộc

The unique identifier of the dispute.

dispute_stage
enum<string>
bắt buộc

The current stage of the dispute process.

Tùy chọn có sẵn:
pre_dispute,
dispute,
pre_arbitration
dispute_status
enum<string>
bắt buộc

The current status of the dispute.

Tùy chọn có sẵn:
dispute_opened,
dispute_expired,
dispute_accepted,
dispute_cancelled,
dispute_challenged,
dispute_won,
dispute_lost
payment_id
string
bắt buộc

The unique identifier of the payment associated with the dispute.

payment_provider
enum<string>
bắt buộc

Which processor handled the underlying payment. stripe / adyen for BYOP routes (the merchant's own payment connector); dodo for everything Dodo processed itself.

Tùy chọn có sẵn:
stripe,
adyen,
dodo
is_resolved_by_rdr
boolean | null

Whether the dispute was resolved by Rapid Dispute Resolution

reason
string | null

Reason for the dispute

remarks
string | null

Remarks

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