Submit a dispute defense and supply defense documents via the Adyen Disputes API

Steps

1. Receive and parse the CHARGEBACK or CHARGEBACK_REVERSED webhook notification from Adyen; extract the disputePspReference from the notification body — this is the only source of the dispute reference
2. POST to /retrieveApplicableDefenseReasons with the disputePspReference and merchantAccountCode to obtain the list of valid defenseReasonCodes for this dispute type
3. For each required document, POST to /supplyDefenseDocument with the disputePspReference, defenseReasonCode, and the base64-encoded document content plus MIME type
4. Once all evidence is uploaded, POST to /defendDispute with the disputePspReference and the chosen defenseReasonCode to formally submit the defense to the scheme
5. Monitor subsequent webhook notifications (DEFENSE_SUBMITTED, WON, LOST) to track the outcome of the dispute