Webhook Payloads
紛争
紛争が作成または更新されたときにウェブフックエンドポイントに送信されるペイロードと、各紛争ライフサイクルイベントをどのように処理するか。
あなたのMerchant of Recordとして、Dodo Paymentsはカードネットワークとの紛争やチャージバックのプロセスを代行して管理します。これらのウェブフックは、紛争がライフサイクルを進むに連れてシステムを同期させ、アクセスを取り消し、証拠を集め、記録を調整できるようにします。
紛争ウェブフックイベント
紛争はそのライフサイクルの各段階でイベントを発行します:| Event | 発生するタイミング | 通常の意味 |
|---|---|---|
dispute.opened | カード保有者が支払いに関する紛争を開いたとき | 資金が保持されるので、対処の準備をする |
dispute.challenged | 紛争に対抗するための証拠が提出されたとき | 紛争はネットワークによって審査中 |
dispute.accepted | 紛争が受け入れられた(対抗しない) | 資金がカード保有者に返還される |
dispute.cancelled | 紛争が取り下げられたまたはキャンセルされた | さらなる行動は不要 |
dispute.expired | 解決せずに応答期間が過ぎたとき | 通常、あなたに不利に解決される |
dispute.won | 紛争があなたに有利に解決されたとき | 資金が保持される |
dispute.lost | 紛争がカード保有者に有利に解決されたとき | 資金がカード保有者に返還される |
Visa Rapid Dispute Resolution (RDR)を通じて自動解決された紛争は、
dispute.lostとis_resolved_by_rdr: trueとして表示されます。これは予測されたものであり、正式なチャージバックを防ぐために自動的に返金されました。紛争イベントの処理
dispute.openedが発生すると、紛争に関する金額が即座に保持されます。このイベントを利用して記録を更新し、対抗するつもりであればダッシュボードで証拠を集めてください。
Handling dispute events
紛争のステータスとステージ
紛争オブジェクトは2つのフィールドを通じて進捗を報告します:| Field | Values |
|---|---|
dispute_status | dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost |
dispute_stage | pre_dispute, dispute, pre_arbitration |
関連情報
Managing Disputes
紛争への対応方法、証拠の提出方法、およびRDRが紛争率をどのように保護するか。
Handle Payment Failures
失敗した支払いが紛争になる前に検出して回収する。
ウェブフックペイロードスキーマ
The amount involved in the dispute, represented as a string to accommodate precision.
The unique identifier of the business involved in the dispute.
The timestamp of when the dispute was created, in UTC.
The currency of the disputed amount, represented as an ISO 4217 currency code.
The unique identifier of the dispute.
The current stage of the dispute process.
利用可能なオプション:
pre_dispute, dispute, pre_arbitration The current status of the dispute.
利用可能なオプション:
dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost The unique identifier of the payment associated with the dispute.
Whether the dispute was resolved by Rapid Dispute Resolution
Remarks
最終更新日 2026年6月18日