Retrieve payment details

post/payments/details

Returns the details of an open payment, which you must show to the user. Also provides a token required to confirm or cancel the payment.

Endpoint destination URL

Request Parameters

Required

Optional

The payment method for the transaction.

Min length: 1Max length: 200

An identifier for the payment, generated by the payment method, such as iDEAL. This is obtained from the specified source.

The source used to obtain the payload. Possible values: qr, redirect, and pushNotification.

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.
detailsobject
The details of the payment. You must show your user these details before they confirm or cancel the payment.
amountobject
The amount of the payment.
currencystring
Min length: 1
The three-character ISO 4217 currency code.
valueinteger
The amount of the transaction in minor units (cents).
counterpartyobject
Contains information about the party that receives the payment funds.
accountHolderobject
Contains the full name of the person or entity that receives the payment funds).
fullNamestring
Min length: 1
Full name of the account holder.
accountIdentificationobject
Contains the account number to which the payment funds are sent.
typestring
descriptionstring
The description for the payment. It is generated by the payment method, such as iDEAL, and should be shown to the user.
expiresAtstring
The expiration date of the payment in ISO DateTime format, as described on ISO 20022 (YYYY-MM-DDThh:mm:ss.sss+/-hh:mm).

Example: 2025-12-30T14:15:30+01:00
tokenstring
Min length: 1
The token that identifies the payment. It is generated by Adyen and is needed to confirm or cancel the payment.
400 - Bad Request
The request is malformed or is not the expected format.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
messagestring
Description of the validation error.
namestring
The field that has an invalid value.
valuestring
The invalid value.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.
422 - Unprocessable Entity
A request validation error.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
messagestring
Description of the validation error.
namestring
The field that has an invalid value.
valuestring
The invalid value.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.
500 - Internal Service Error
An unrecoverable error occurred while trying to perform the request.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
messagestring
Description of the validation error.
namestring
The field that has an invalid value.
valuestring
The invalid value.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.

Retrieve payment details

HTTP Responses

200 - OK

400 - Bad Request

422 - Unprocessable Entity

500 - Internal Service Error