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:
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
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
Last updated
Was this helpful?