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 を参照してください。

異議申し立てのステータスとステージ

異議申し立てオブジェクトでは、2 つのフィールドを使用して進捗状況を示します。

関連情報

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日