Dispute Attachments

Add an attachment to a dispute

Changed on Oct 6, 2025

Add supporting information as an attachment for the raised dispute. Upload receipts, communication, or any other documentation to support the dispute.

post/disputes/{disputeId}/attachments

Request

Base URL
https://balanceplatform-api-live.adyen.com/btl/api/v4
URL
https://balanceplatform-api-live.adyen.com/btl/api/v4/disputes/{disputeId}/attachments
Auth
none declared

Path parameters

disputeIdstring required

The unique identifier of the raised dispute.

Request body

attachmentType'receipt' | 'correspondence' | 'other' required

contentstring required

The content of the image. An attachment must be base64-encoded data. Make sure that all base64-encoded data strings are generated without line breaks or "wrapping". For example, do not use Base64.NO_WRAP in Java, or its equivalent in other languages. Newline characters at the end of the base64-encoded data string will also result in a malformed input error.

fileNamestring required

The name of the attachment, including its filename extension. Supported filename extensions: jpeg, pdf, tiff.

idstring

The unique identifier of the attachment.

Response

OK - the request has succeeded.

attachmentIdstring