Skip to main content
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
처리하기 전에 항상 webhook 서명을 확인하세요. 설정 방법은 Webhooks guide를 참조하세요. 위 핸들러에서는 간결성을 위해 서명 확인을 생략했습니다.
분쟁이 생성된 후 10일 이내에 응답해야 합니다. 수집해야 할 증거와 형식 지정 방법은 Dispute Response Best Practices를 참조하세요.

분쟁 상태 및 단계

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

관련 문서

Managing Disputes

분쟁에 대응하고 증거를 제출하는 방법과 RDR이 분쟁률을 보호하는 방법을 알아보세요.

Handle Payment Failures

실패한 결제가 분쟁으로 이어지기 전에 이를 감지하고 복구하세요.

Webhook 페이로드 스키마

amount
string
필수

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

brand_id
string
필수

Brand id this dispute belongs to

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.

customer
object
필수

The customer who filed the dispute

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.

payment_provider
enum<string>
필수

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

사용 가능한 옵션:
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

마지막 수정일 2026년 9월 26일