메인 콘텐츠로 건너뛰기
Merchant of Record로서 Dodo Payments는 카드 네트워크와의 분쟁 및 차지백 프로세스를 대신 관리합니다. 이러한 웹훅은 분쟁이 라이프사이클을 통해 진행되는 동안 시스템을 동기화하여 액세스를 철회하고 증거를 수집하며 기록을 조정할 수 있도록 합니다.

분쟁 웹훅 이벤트

분쟁은 라이프사이클의 각 단계에서 이벤트를 발생시킵니다:
Visa Rapid Dispute Resolution (RDR)를 통해 자동 해결된 분쟁은 dispute.lostis_resolved_by_rdr: true로 나타납니다. 이는 기대된 결과입니다 — 환불이 공식 차지백을 방지하기 위해 자동으로 발행되었습니다.

분쟁 이벤트 처리

dispute.opened가 발생하면 분쟁된 금액이 즉시 보류됩니다. 이벤트를 사용하여 기록을 업데이트하고, 다투고자 한다면 대시보드에서 증거를 수집하십시오.
Handling dispute events
처리하기 전에 항상 웹훅 서명을 확인하십시오 — 설정에 대해서는 웹훅 안내서를 참조하십시오. 위 핸들러는 간결성을 위해 확인을 생략합니다.
분쟁이 생성된 후 4일 이내에 응답해야 합니다. 분쟁 대응 모범 사례에서 증거를 수집하고 형식화하는 방법을 자세히 알아보십시오.

분쟁 상태 및 단계

분쟁 객체는 두 가지 필드를 통해 진행 상황을 보고합니다:

관련 항목

Managing Disputes

분쟁에 응답하고, 증거를 제출하며, RDR이 분쟁율을 어떻게 보호하는지에 대한 내용입니다.

Handle Payment Failures

실패한 결제를 감지하고 복구하여 분쟁으로 발전하기 전에 해결하십시오.

웹훅 페이로드 스키마

amount
string
필수

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

business_id
string
필수

The unique identifier of the business involved in the dispute.

created_at
string<date-time>
필수

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

currency
string
필수

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

dispute_id
string
필수

The unique identifier of the dispute.

dispute_stage
enum<string>
필수

The current stage of the dispute process.

사용 가능한 옵션:
pre_dispute,
dispute,
pre_arbitration
dispute_status
enum<string>
필수

The current status of the dispute.

사용 가능한 옵션:
dispute_opened,
dispute_expired,
dispute_accepted,
dispute_cancelled,
dispute_challenged,
dispute_won,
dispute_lost
payment_id
string
필수

The unique identifier of the payment associated with the dispute.

is_resolved_by_rdr
boolean | null

Whether the dispute was resolved by Rapid Dispute Resolution

remarks
string | null

Remarks

마지막 수정일 2026년 6월 18일