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://primeiropay.docs.oppwa.com/reference/resultCodes	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