Issuin icon

Manage disputes

Edit information about a dispute, and submit or close a raised dispute.

When a dispute has a status of draft, you can edit the information associated with the dispute, and change the status of the dispute to submitted or closed. You can also provide supporting information as attachments for the dispute.

Edit dispute information

To update information in your dispute, make a PATCH /disputes/{id} request, specifying the dispute id as a path parameter, and supplying updated information in the following request parameters:

Submit a dispute

  1. Make a PATCH /disputes/{id} request, specifying the dispute id as a path parameter, and include status with a value of submitted as a request parameter.

  2. A successful response includes the dispute object, with an updated status of submitted. Adyen also sends your system a balancePlatform.dispute.updated webhook with the updated status.

  3. Notify your cardholder that they have successfully submitted their dispute.

Close a dispute

You can change the status of a dispute to closed when you no longer intend to submit the dispute. You can only close a dispute whose status is draft.

After you close a dispute, you cannot edit, submit, or reopen that dispute.

  1. Make a PATCH /disputes/{id} request, specifying the dispute id as a path parameter, and include status with a value of closed as a request parameter.

  2. A successful response includes the dispute object, with an updated status of closed. Adyen also sends your system a balancePlatform.dispute.updated webhook with the updated status.

  3. Notify your cardholder that they have successfully closed their dispute.

See also