> For the complete documentation index, see [llms.txt](https://developers.primeiropay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.primeiropay.com/disputes/dispute-notifications-via-webhooks.md).

# Dispute notifications via webhooks

PrimeiroPay sends dispute information via webhooks to inform the merchant about the current status of the dispute.

The merchant shall inform a listener HTTPS URL to its account manager in order to set up this feature.

When your service receives a webhook notification, it must return a **200** HTTP status code. Otherwise, the webhook service considers the notification delivery as failed. PrimeiroPay currently does not retry failed webhooks.

**Example:** 

```
{
  "uniqueId":"777777777777777",
  "merchantId":"8acda4cb6193d56a0161949d31de0dda",
  "merchantTransactionId":"1331837",
  "amount":1762.0,
  "caseNumber":"26379847",
  "chargebackCountRequest":1,
  "disputeEndDateTime":"2019-10-09 21:00:00.000",
  "notificationDateTime":"2019-10-02 11:00:00.000",
  "status":"WIN",
  "acquirerReasonCodeId":77,
  "adyenMerchantRefId":"4147",
  "reasonCode":"000.100.222",
  "disputeReason":"Transaction Not Recognized By Cardholder",
  "brand":"MASTERCARD",
  "brandReasonCode":"4837"
}
```

**Frequency**

Whenever the “status” changes a webhook is being sent to the listener URL.\
A dispute notification can have the following status:\
*OPEN*\
*WIN*\
*LOSE*\
\
**The merchant receives therefor maximum three notifications for a single transaction**. PrimeiroPay currently does not retry failed webhooks.

| **Name**               | **Description**                                                                                     | **Format**                    | **Example**                              |
| ---------------------- | --------------------------------------------------------------------------------------------------- | ----------------------------- | ---------------------------------------- |
| UniqueId               | Unique Identifier for PrimeiroPay                                                                   | AN \[a-zA-Z0-9\_]             | 8a83948355021710015507ccee0869a1         |
| merchantId             | Unique Identifier of the merchant for PrimeiroPay                                                   | AN \[a-zA-Z0-9\_]             | 8a83948355021710015507ccee0869a1         |
| merchantTransactionId  | Unique id of the transaction related to the dispute, if connected via Adyen it is the PSP Reference | AN \[a-zA-Z0-9\_]             | 8a83948355021710015507ccee0869a1         |
| amount                 | Amount of original transaction                                                                      | N13\[0- 9]{1,10}\\.\[0 -9]{2} | 54.12                                    |
| caseNumber             | Identification of the dispute at the acquirer                                                       | AN \[a-zA-Z0-9\_]             | 2791QAT326851                            |
| chargebackCountRequest | Indicates how many chargebacks were issued for the same transaction                                 | N2\[0- 9]{1,10}               | 1                                        |
| disputeEndDateTime     | Date and time of until the dispute will be open and accepting defense materials.                    | YYYY-MM-DD HH:MM:SS.sss       | 2019-10-09 21:00:00.000                  |
| notificationDateTime   | Date and time of when the notification was received by PrimeiroPay                                  | YYYY-MM-DD HH:MM:SS.sss       | 2019-10-09 21:00:00.000                  |
| Status                 | Open for new transactions, Win or Lose for when you win or lose a dispute.                          | AN \[a-zA-Z0-9\_]             | Win                                      |
| acquirerReasonCodeId   | Description of the reason code                                                                      | N3\[0- 9]{1,10}               | 77                                       |
| adyenMerchantRefId     | Merchant Reference ID from Adyen if Merchant is connected through Adyen to PrimeiroPay              | AN \[a-zA-Z0-9\_]             | 4147                                     |
| reasonCode             | Result codes as listed: <https://developers.primeiropay.com/result-codes>                           | AN \[NNN.NNN.NNN]             | 000.100.222                              |
| disputeReason          | Description/reason of the dispute, according to it’s reason code.                                   | AN \[a-zA-Z0-9\_]             | Transaction Not Recognized By Cardholder |
| brand                  | Card Brand of the dispute                                                                           | AN \[a-zA-Z0-9\_]             | MASTERCARD                               |
| brandReasonCode        | Reason code using Brand’s specification code.                                                       | AN \[a-zA-Z0-9\_]             | 4837                                     |