The disputes report retrieves a list of disputes that occurred within a defined timeframe and the status of the dispute if it changed within that timeframe.

Report properties


Report available for	Disputes within the latest 90 days
Report period	Max 90 days
File format	`CSV`
Report level	Merchant

Request payload

Field	Required	Values	Description
`startDate`	Yes	Example: `"2026-01-01T00:00:00.000Z"`	The report cutoff start date in ISO 8601 date-time.
`endDate`	Yes	Example: `"2026-01-31T23:59:59.999Z"`	The report cutoff end date in ISO 8601 date-time.

📘
The webhook URL is not yet available for this report.

Example:

{
  "startDate": "2026-04-04T00:00:00.000Z",
  "endDate": "2026-04-06T23:59:59.999Z"
}

Report format

Column name	Type	Description
`REPORT_DATE`	`string`	Timestamp when the report was generated in ISO 8601 format.
`DISPUTE_ID`	`string`	Unique identifier for the dispute at PPRO.
`PAYMENT_CHARGE_ID`	`string`	Identifier of the associated payment charge at PPRO.
`MERCHANT_ID`	`string`	Identifier of the merchant linked to the dispute.
`MERCHANT_PAYMENT_REFERENCE`	`string`	Optional reference provided by the merchant for the operation.
`PAYMENT_METHOD`	`string`	Payment method used (e.g., `PIX` `CARD` `WERO`).
`RECORD_DATE`	`string`	Timestamp when the dispute was updated in ISO 8601 format.
`PROVIDER_DISPUTE_DATE`	`string`	Timestamp when the dispute was raised at the provider.
`DISPUTE_CURRENCY`	`string`	Currency code in ISO 4217 format.
`DISPUTE_AMOUNT`	`integer`	Amount of the dispute.
`DISPUTE_REASON_CODE`	`string`	The PPRO dispute reason code (e.g., `PDSP_AUTH_001`, `PDSP_PROD_001`)
`DISPUTE_PHASE`	`string`	Dispute phase (e.g., `PRE_DISPUTE`, `DISPUTE`, `PRE_ARBITRATION`, `ARBITRATION`)
`DISPUTE_STATUS`	`string`	Status of the dispute (e.g., `OPEN`, `UNDER_REVIEW`)
`DISPUTE_DUE_BY`	`string`	Timestamp when a response is due by in ISO 8601 format.

CSV example

REPORT_DATE, DISPUTE_ID, PAYMENT_CHARGE_ID, MERCHANT_ID, MERCHANT_PAYMENT_REFERENCE, PAYMENT_METHOD, RECORD_DATE, PROVIDER_DISPUTE_DATE, DISPUTE_CURRENCY, DISPUTE_AMOUNT, DISPUTE_REASON_CODE, DISPUTE_PHASE, DISPUTE_STATUS, DISPUTE_DUE_BY
2025-04-04T04:42:20.892Z,dispute_sCTH5JVxsTKb9XDnBbttg,charge_KnBhDYtulJRmNvNve5UDQ,26819159-3774-4ad7-bf5f-854dee69895e,123abc,card,2026-07-14T17:08:24.094400887Z,2026-07-14T00:00:00Z,BRL,4300,PDSP_AUTH_001,DISPUTE,DISPUTE_OPEN,2026-07-21T17:08:24:00Z