POST /v1/quotes/cost/preview with a quote total to get indicative monthly payments and widget URLs. See the API reference for the full request and response schema.
Every successful response includes links.loanIndicationWidget with two ready-to-use URLs:
amount query parameter set to the totalInclTax from the request — the exact total the customer is financing. They are ready to use as-is. Do not hardcode a fixed amount; always use the value returned by the API.
When you render representative examples from data.representativeExamples (in custom UI or alongside a widget), display the mandatory text_warning from data.content prominently — for example “Let op! Geld lenen kost geld”.
Screenshot
Uselinks.loanIndicationWidget.png directly in an <img> tag:
Financing Snapshot
Drop a single<script> tag where you want the widget to appear. Set src to your Prets domain — no CDN setup needed. Use the amount from links.loanIndicationWidget.url.
data-amount to the totalInclTax from the quote.
Financing Explorer
The Financing Explorer adds interactive controls so customers can adjust the loan amount, down payment, and loan duration before clicking through to onboarding.data-amount to the totalInclTax from the quote.
Keeping the amount in sync
Theamount query parameter is what drives the monthly cost displayed in the widget. It must always match the total the customer is actually financing.
- Use the
amountfromlinks.loanIndicationWidget.urlorlinks.loanIndicationWidget.pngdirectly — both are already correct. - If the quote total changes — for example, the customer adjusts line items — call
POST /v1/quotes/cost/previewagain and use the new links from the updated response. - Do not hardcode an amount. A fixed value will show costs that do not match the customer’s actual quote.