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

Disputes

Disputes guides

Last modified 2yr ago

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