---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/risk/disputesAPI/index.md
description: 说明 Disputes API 的能力范围，覆盖调单和拒付查询、材料上传、申诉提交或放弃等争议处理动作。
---
## dispute API

如果您希望通过服务端处理争议案件，本页既提供接入流程，也提供 API 快速入口。

::: tip 使用边界
- 本页保留争议处理流程和接入顺序。
- 具体字段、请求示例、响应结构，请以各 API 详情页为准。
- 事件含义和回调处理方式，请查看 [拒付通知接入说明](/notes/zh/risk/disputeNotify/)。
:::

为了让您快速管理发生的争议，我们提供了 dispute API。您可以通过这些接口自动执行争议处理流程，在争议发起后尽快响应。

### API 快速入口

- [主动获取调单明细](/notes/zh/dispute/v4-apis/getRetrievalDispute/)
- [主动获取拒付/未升级争议明细](/notes/zh/dispute/v4-apis/getDisputeInfo/)
- [查询拒付抗辩材料](/notes/zh/dispute/v4-apis/getDefenseReasons/)
- [上传文件](/notes/zh/dispute/v4-apis/disputeUploadFile/)
- [上传拒付材料](/notes/zh/dispute/v4-apis/supplyDefenseDocument/)
- [删除拒付材料](/notes/zh/dispute/v4-apis/deleteDefenseDocument/)
- [提交材料并进行抗辩](/notes/zh/dispute/v4-apis/defendDispute/)
- [放弃申诉](/notes/zh/dispute/v4-apis/acceptDispute/)

## dispute API 处理流程

### 拒付流程

<a href="/notes/zh/technicalterm/disputes/" target="_blank">调单</a>发生时，发卡行会要求提供有关交易的更多信息。在这个阶段，您的账户中不会提取款项，建议您积极处理。
<br/>
<br/>
<v4-iImage src = "/v4/dispute/dispute.png" name = "整体流程图"></v4-iImage><br/>

使用 Disputes API 时，您需要执行以下操作：

+ 处理拒付通知。使用<a href="/notes/zh/risk/disputeNotify/" target="_blank">eventCode</a>来确定拒付处于哪个阶段。
+ 检索拒付信息以了解如何为争议辩护，比如调用<a href="/notes/zh/dispute/v4-apis/getDefenseReasons/" target="_blank">查询拒付抗辩材料</a>。
+ 如果您想为争议辩护，请继续执行第 3 步。
<ul>
<li>可选：如果您不想为争议辩护，请<a href="/notes/zh/dispute/v4-apis/acceptDispute/" target="_blank">放弃申诉</a>。</li>
<li>可选：上传争议的所有相关辩护材料。在对争议进行抗辩之前，可以调<a href="/notes/zh/dispute/v4-apis/deleteDefenseDocument/" target="_blank">删除拒付材料</a>接口对已上传的拒付材料进行删除。</li>
</ul>

+ <a href="/notes/zh/dispute/v4-apis/defendDispute/" target="_blank">提交材料并进行抗辩</a>

### 流程背景

- [争议总览](/notes/zh/risk/overview/)
- [Disputes-争议](/notes/zh/technicalterm/disputes/)
- [Chargebacks-拒付](/notes/zh/technicalterm/chargebacks/)