Disputes Webhook
This document explains the purpose of the disputes webhook and the structure of the notifications and data sent.
On this page
Your buyers can present a claim to their card issuing bank. The bank sends us a dispute notification to determine the validity of the purchase, and we create the dispute in our system. After we create the dispute, we notify you through the PayU Module.
The dispute freezes the total amount of the sale in your PayU account.
A buyer can claim to their card issuer bank reporting that they have not received a product, the product is deficient, or it does not meet the expected characteristics. The buyer also can disclaim the purchase of their credit card invoice.
The reasons for starting a dispute process may vary, some of them are:
Not all the financial entities use the same mechanisms to notify a dispute; therefore, PayU cannot guarantee that you can always know the reasons of the dispute.
The disputes process follows a simple flow:
When a bank or a processing network notifies PayU about the start of a dispute process due to a claim of your customer, you can consult all the information related to it in the Disputes module of the PayU Module.
If you have configured the notification e-mails in your PayU module, you also receive the dispute information vía e-mail. Furthermore, when you have enabled the Automatic notification URL, we also send a POST
notification. This way, you can automate your dispute management processes to minimize the risk of a possible chargeback.
You can configure the URL where we make the notification in the PayU module. Log in to PayU.com and click the login option located at the top of the page. Alternatively, you can log in to https://merchants.payulatam.com/.
Click Settings and then select Technical configuration.
In this window, go to Disputes tab and define the dispute notification url and enable the notification box in the Automatic notification URL field.
Once you configured this, you automatically receive a POST with all the information of the started dispute process. Furthermore, You also receive a notification POST each time the dispute process has an update, so you can be aware of the progress and completion of this process.
You can view and manage your dispute processes from your PayU module, in the Dispute option inside the Transactions menu.
It’s important to always respond a dispute by providing evidence before the deadline stipulated by the bank or the processing network. After the deadline date, you cannot upload the corresponding evidence for a dispute.
To learn how to upload evidence to resolve the dispute, refer to the PayU module.
Recall that the maximum days to provide evidence for each country are:
Country | Days to provide 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 the evidence is provided, we send the documents to the issuing bank or the network that processed the transaction, which oversees the resolution of the case. The result of dispute can be: won (without chargeback), lost (chargeback) or refunded. In the case of refunds, the shop makes the return to the buyer and the bank does not create the chargeback.
When the bank announces the dispute’s outcome, the case is automatically updated in the administrative module and PayU sends a POST to the configured URL with information of the final result.
When a dispute is reported, a dispute entity for the associated transaction is created. The dispute status changes according to the step where the dispute is within the course of the process.
State | Description |
---|---|
Notified | When the dispute process begins, you must upload the evidence for the dispute. |
On Payment Network Review | When the shop provides evidence for a dispute through the PayU module and the dispute is reviewed by the bank or network. |
Documents not provided | The deadline date to provide evidence has been reached and the commerce did not provide any documentation. |
Lost | The transaction is reversed from the virtual shopping account and may incur in a chargeback management cost. |
Won | The dispute process is resolved in favor of the shop, there are no deductions of any kind. |
Expired | After past 120 days without a response from the bank, the amount is set to available for the merchant. |
Refunded | This process occurs when the shop authorizes to reverse the operation in self-determination, this prevents the shop from having to pay a chargeback transaction and it is replaced by a refund. |
Below is a diagram illustrating the flow for handling payment disputes:
Fight against the digital fraud it’s our duty!. Take into account the following tips:
This document explains the purpose of the disputes webhook and the structure of the notifications and data sent.