Dispute a PayPal transaction via the PayPal Disputes API and submit evidence

Steps

1. Listen for the CUSTOMER.DISPUTE.CREATED webhook event from PayPal; extract the dispute ID and the associated transaction ID from the event payload.
2. Call the Disputes API GET endpoint with the dispute ID to retrieve the full dispute details including the dispute reason, the disputed amount, and the response deadline.
3. Gather evidence relevant to the dispute reason: for item-not-received disputes, collect tracking numbers and delivery confirmation; for significantly-not-as-described disputes, collect product photos and policy documents.
4. Submit your evidence by calling the provide-evidence action endpoint on the dispute; attach files by uploading them as multipart form data and include a note explaining the evidence.
5. If you choose to accept the claim instead of contesting, call the accept-claim action endpoint; PayPal will process the refund.
6. Monitor the dispute status by polling the dispute GET endpoint or listening for CUSTOMER.DISPUTE.UPDATED webhooks until the status reaches RESOLVED.