Issuin icon

Provide supporting information as attachments

Add supporting documentation for a raised dispute, and manage attachments.

Before you submit a dispute, recommend that you include attachments as supporting information. Examples of supporting information are screenshots or photos of receipts, email communication with the merchant, or any other information the card scheme can review to make a decision on the dispute.

Make sure any photos you attach to your dispute are in-focus and not blurry. Attachments must be in Base64-encoded string format.

Upload an attachment

  1. Make a POST /disputes/{disputeId}/attachments request, specifying the disputeId as a path parameter and the following request parameters.

    Parameter name Type Required Description
    attachmentType string yes The type of information contained in the attachment.
    Possible values:
    • receipt
    • correspondence
    • other
    fileName string yes The name of the attachment, including its filename extension. Minimum length: four characters, Maximum length: 17 characters, including the extension type.
    Supported filename extensions:
    • jpeg
    • pdf
    • tiff
    Examples:
    • airfare24_03.jpeg
    • hotel24_0315.jpeg
    content string yes The content of the image. An attachment must be Base64-encoded data.

  2. In the response, note the attachmentId. You may need the ID if you want to later get the attachment, or delete the attachment.

    Parameter name Type Description
    attachmentId string The unique identifier of the attachment.

Get an attachment

You can retrieve an attachment associated with a dispute when you know the specific dispute ID and attachment ID you want.

  1. Make a GET /disputes/{disputeId}/attachments/{attachmentId} request, specifying the dispute id and the attachmentId as path parameters.

  2. The response contains the attachment id, the fileName, the attachmentType, and the content of the attachment in base64-encoded string format.

Get a list of attachments

You can retrieve a list of all attachments associated with a specific dispute.

  1. Make a GET /disputes/{disputeId}/attachments/ request, specifying the disputeId as a path parameter.

  2. The response contains all attachments associated with the dispute.

Delete an attachment

You may want to delete an attachment associated with a dispute in some cases. For example, your cardholder uploaded the wrong attachment and wants to remove it from the dispute.

Adyen may retain files attached to disputes for auditing and compliance purposes.

To delete an attachment:

  1. Make a DELETE /disputes/{disputeId}/attachments/{attachmentId} request, specifying the disputeId and attachmentId as path parameters.

  2. If your request to delete the attachment is successful, you receive an HTTP 204 - No Content status code as a response.

See also