Disputes API

https://ca-test.adyen.com/ca/services/DisputeService/v30
Click to copy

You can use the Disputes API to automate the dispute handling process so that you can respond to disputes and chargebacks as soon as they are initiated. The Disputes API lets you retrieve defense reasons, supply and delete defense documents, and accept or defend disputes.

Authentication

Each request to the Disputes API must be signed with an API key. For this, obtain an API Key from your Customer Area, as described in How to get the API key. Then set this key to the X-API-Key header value, for example:

curl
-H "Content-Type: application/json" \
-H "X-API-Key: Your_API_key" \
...

Note that when going live, you need to generate new web service user credentials to access the live endpoints.

Versioning

Disputes API supports versioning using a version suffix in the endpoint URL. This suffix has the following format: "vXX", where XX is the version number.

For example:

https://ca-test.adyen.com/ca/services/DisputeService/v30/defendDispute
post/acceptDispute
Accept a dispute
post/defendDispute
Defend a dispute
post/deleteDisputeDefenseDocument
Delete a defense document
post/retrieveApplicableDefenseReasons
Get applicable defense reasons
post/supplyDefenseDocument
Supply a defense document