Webhook Payloads
분쟁 Webhooks
분쟁이 생성되거나 업데이트될 때 webhook 엔드포인트로 전송되는 페이로드입니다. 각 이벤트를 처리하여 분쟁에 대응하고 기록을 조정하세요.
Merchant of Record로서 Dodo Payments는 카드 네트워크와의 분쟁 및 차지백 프로세스를 대신 관리합니다. 이러한 웹훅은 분쟁이 라이프사이클을 통해 진행되는 동안 시스템을 동기화하여 액세스를 철회하고 증거를 수집하며 기록을 조정할 수 있도록 합니다.
분쟁 웹훅 이벤트
분쟁은 라이프사이클의 각 단계에서 이벤트를 발생시킵니다:Visa Rapid Dispute Resolution (RDR)를 통해 자동 해결된 분쟁은
dispute.lost와 is_resolved_by_rdr: true로 나타납니다. 이는 기대된 결과입니다 — 환불이 공식 차지백을 방지하기 위해 자동으로 발행되었습니다.Ethoca alerts 및 deflections은 분쟁을 생성하지 않으므로
dispute.* 이벤트를 생성하지 않습니다. Ethoca alert 환불은 표준 refund.succeeded 이벤트를 발생시키며, 연결된 구독이 취소되면 일반적인 구독 이벤트가 발생합니다. deflection은 이벤트를 발생시키지 않습니다.분쟁 이벤트 처리
dispute.opened이 발생하면 분쟁 금액이 즉시 보류됩니다. 이벤트를 사용하여 기록을 업데이트하고, 이의를 제기할 계획이라면 대시보드에서 증거를 수집하세요.
Handling dispute events
분쟁 상태 및 단계
분쟁 객체는 다음 두 필드를 통해 진행 상황을 보고합니다:관련 문서
Managing Disputes
분쟁에 대응하고 증거를 제출하는 방법과 RDR이 분쟁률을 보호하는 방법을 알아보세요.
Handle Payment Failures
실패한 결제가 분쟁으로 이어지기 전에 이를 감지하고 복구하세요.
Webhook 페이로드 스키마
마지막 수정일 2026년 9월 26일