メインコンテンツへスキップ
バージョン: 最新版

Disputes API

Disputes APIを使用すると、顧客がカード発行銀行に申し立てた決済異議申し立て（チャージバック）を管理できます。顧客が決済に異議を申し立てた場合、証拠を提出して異議申し立てに対応できます。

概要​

異議申し立ては、顧客が銀行やクレジットカード会社に決済について疑問を呈した際に発生します。一般的な理由は以下の通りです。

  • 不正取引 - 顧客が決済を承認していない
  • 商品未受領 - 顧客が商品やサービスを受け取っていないと主張
  • 商品が受け入れられない - 商品が説明と大幅に異なる
  • 重複請求 - 顧客が複数回請求された
  • 返金未処理 - 返金が約束されたが受け取っていない

異議申し立てのライフサイクル​

  1. Open - 顧客によって異議申し立てが提出され、資金が残高から引き出される
  2. Pending - 証拠を提出済み、銀行の決定を待っている状態
  3. Won - 異議申し立てがあなたに有利に解決され、資金が返還される
  4. Lost - 異議申し立てが顧客に有利に解決され、資金が永久に失われる
  5. Closed - 異議申し立てがクローズされた（wonまたはlost状態を含む）

主要な概念​

異議申し立てのステータス​

  • open - 証拠による応答を待っている状態
  • pending - 証拠が提出済み、発行銀行による審査中
  • won - 異議申し立てに勝利
  • lost - 異議申し立てに敗北

応答期限​

  • 通常、証拠を提出するまでに14〜21日の期間があります
  • 期限を過ぎると自動的に敗北となります
  • 異議申し立てオブジェクトのcharge_dispute_at日付を確認してください

証拠書類​

証拠はあなたのケースを強化します。以下のような書類をアップロードできます。

  • 配送証明（追跡番号、署名付き受領書）
  • 顧客とのやり取り（メール、チャットログ）
  • 利用規約
  • 商品の説明・写真
  • 返金・キャンセルポリシー

利用可能なエンドポイント​

ベストプラクティス​

✅ 推奨事項​

  • 迅速に対応する - 期限まで待たずに異議申し立てに対応してください
  • 包括的な証拠を提供する - より多くの書類を提出することをお勧めします
  • 詳細な記録を保持する - すべての顧客とのやり取りと配送証明を保存してください
  • Webhookを設定する - 異議申し立てが発生したらすぐに通知を受け取れるようにします
  • 明確な説明を使用する - 決済に明確な説明を付けて混乱を防ぎます
  • 優れた顧客サービスを提供する - 異議申し立ての可能性を減らします

❌ 避けるべきこと​

  • 異議申し立てを無視しない - 応答しないと自動的に敗北となります
  • 無関係な証拠を提供しない - 異議申し立ての理由に対処することに焦点を当ててください
  • 勝てると思い込まない - 銀行は一般的に顧客を優先します
  • メール通知を待たない - リアルタイムアラートのためにWebhookを使用してください

Webhookイベント​

異議申し立てを監視するために以下のイベントを購読してください。

  • charge.dispute.create - 新しい異議申し立てが提出された
  • charge.dispute.update - 異議申し立てのステータスが変更された
  • charge.dispute.close - 異議申し立てがクローズされた（wonまたはlost）

関連リソース​

サポートが必要ですか？ 異議申し立てに関するサポートについては、support@omise.coまでお問い合わせください。