Disputes Webhook
This document explains the purpose of the disputes webhook and the structure of the notifications and data sent.
On this page
For detailed instructions on handling disputes through your PayU account’s Management Panel, refer to the Disputes Module documentation.
For technical information about the notifications system, refer to the Disputes Webhook documentation.
Disputes arise when buyers file claims with their card-issuing banks regarding transactions. The bank notifies PayU of the dispute, and we create a corresponding record in our system. Afterward, we notify you based on the notification method you chose.
The following diagram illustrates the flow of the disputes process in PayU, outlining each step from notification to resolution.
Buyers may dispute transactions for various reasons, including non-receipt of goods, defective products, or unauthorized charges. Here are the typical dispute reasons:
The disputes process follows a structured flow, which you can manage directly through the Management Panel in your PayU account. For more details, refer to the Disputes Module.
PayU will notify you based on the notification method that you configured in the Disputes module, where you can also check the dispute’s details.
Use the Management Panel to view and manage your ongoing disputes.
Respond to disputes by submitting the required evidence through the Disputes module before the deadline set by the bank or processing network. After the deadline, you won’t be able to upload evidence for that dispute.
The maximum days for evidence submission vary by country:
Country | Days to Submit Evidence |
---|---|
Argentina | 5 working days |
Brazil | 12 working days |
Chile | 5 working days |
Colombia | 2 working days |
Mexico | 12 calendar days |
Panama | 8 working days |
Peru | 6 working days |
Once you submit the evidence, our integration forwards it to the bank or processing network for review. Outcomes may include:
Your PayU account’s Management Panel will update the dispute status based on the resolution and the system will notify you.
Each dispute follows a series of states throughout the process:
State | Description |
---|---|
Notified | Initial state where evidence must be submitted. |
Under Review | Evidence is being reviewed by the bank or network. |
No Evidence Provided | The merchant missed the deadline for submitting evidence. |
Lost | The dispute was resolved in favor of the buyer, resulting in a chargeback. |
Won | The dispute was resolved in favor of the merchant. |
Expired | After 120 days without a bank response, funds are released. |
Refunded | The merchant authorized a refund, avoiding a chargeback. |
Below is a diagram illustrating the dispute resolution process:
Protect your business from fraud by following these tips:
This document explains the purpose of the disputes webhook and the structure of the notifications and data sent.