Get dispute by ID

get/disputes/{id}

Get a raised dispute by ID.

Endpoint destination URL

Path Parameters

Required

Optional

The unique identifier of the raised dispute.

Response parameters

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

200 - OK
The request has succeeded.
Show more Show less
arnstring
The unique Acquirer Reference Number (arn) generated by the card scheme for each capture. You can use the arn to trace the transaction through its lifecycle.
descriptionstring
Your description for the dispute.
disputedAmountobject
The amount for which you dispute the transaction. The disputed amount cannot be greater than the transaction amount. If you do not provide an amount, the entire transaction amount will be disputed.
Show children Hide children
currencystring
The three-character ISO currency code.
valueinteger
The amount of the transaction, in minor units.
fraudInfoobject
Additional information for raising a dispute of type fraud. Required for disputes of type fraud.
Show children Hide children
cardDoesNotBelongToCardholderboolean
The card is no longer in the cardholder's possession. Set to true if the card is lost or stolen.
cardWasCounterfeitedboolean
The card was counterfeited.
descriptionOfIssuestring
Your description of the issue for raising a dispute of type fraud.
reportOnlyboolean
Set to true to report fraud to Adyen with no further action, such as a request for a chargeback or fee reversal. The default value is false.
idstring
The unique identifier of the raised dispute.
notDeliveredInfoobject
Additional information for raising a dispute of type notDelivered. Required for disputes of type notDelivered.
Show children Hide children
dateOfCancellationstring
The date the undelivered goods or services were cancelled in YYYY-MM-DD format.
descriptionOfIssuestring
Your description of the issue for raising a dispute of type notDelivered.
lastExpectedDatestring
The date the undelivered goods or services were expected to be delivered in YYYY-MM-DD format.
whatWasNotDeliveredstring
The type of product that you expected to receive.

Possible values: goods, services.
whoCancelledstring
The party that initiated the cancellation of the transaction.

Possible values: merchant, cardholder.
statusstring
The current status of the dispute.

You can update a dispute to submitted or closed.

Possible values: draft, submitted, closed, won, chargeback, secondPresentment.
transactionIdstring
The unique reference of the transaction for which you are raising the dispute.
typestring
The type of the dispute.

Possible values: notDelivered, fraud.

Get dispute by ID

Path Parameters

Response parameters

HTTP Responses

200 - OK