Calculate a preliminary offer for a selected financing amount

post/dynamicOffers/{id}/calculate

API Version

Calculates a preliminary offer for the financing amount that the user selected from a dynamic offer. The preliminary offer is for informational purposes only and cannot be used to initiate a grant.

Requests to this endpoint are subject to rate limits:

Live environments: 120 requests per minute.
Test environments: 120 requests per minute.

Endpoint destination URL

Path Parameters

Required

Optional

Min length: 1

The unique identifier of the dynamic offer from which the user selected the financing amount.

Request Parameters

Required

Optional

The financing amount that the user selected from a dynamic offer. Adyen uses this amount to calculate a preliminary offer.

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.
accountHolderIdstring
The unique identifier of the account holder that the dynamic offer is for.
amountobject
The financing amount that would be paid out to your user.
currencystring
The three-character ISO currency code of the amount.
valueinteger
The numeric value of the amount, in minor units.
contractTypestring
The contract type of the offer.

Possible values:

loan

cashAdvance

expiresAtstring
The expiration date and time of the offer validity period.
feeobject
Contains information about the fee that your user would pay for the grant.
amountobject
Contains the amount of the offer fee.
currencystring
The three-character ISO currency code of the amount.
valueinteger
The numeric value of the amount, in minor units.
aprBasisPointsinteger
Annual Percentage Rate (APR) of the offer. The percentage is expressed in basis points.
repaymentobject
Contains information about the repayment configuration of the grant.
basisPointsinteger
The percentage of your user's incoming net volume that is deducted for repaying the grant. The percentage expressed in basis points.
termobject
Contains information about the time period in which your user must repay the total amount of the grant.
estimatedDaysinteger
The estimated duration of the repayment term, in days.
maximumDaysinteger
The maximum duration of the repayment term, in days. Only applies when contractType is loan.
thresholdobject
Contains the minimum threshold amount that your user must repay every 30-day period.
amountobject
The minimum threshold amount that your user must repay on every 30-day period.
currencystring
The three-character ISO currency code of the amount.
valueinteger
The numeric value of the amount, in minor units.
startsAtstring
The starting date and time of the offer validity period.
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.

Calculate a preliminary offer for a selected financing amount

HTTP Responses

200 - OK

422 - Unprocessable Entity