200 response from POST /v1/quotes/cost/preview includes a links.loanIndicationWidget object 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.
| Option | What it is | Best for |
|---|---|---|
| Screenshot | Static PNG image rendered on-demand by Prets | Email quotes, PDF attachments, CMS pages |
| Financing Snapshot | Live embedded widget showing 3 financing cards at a fixed amount | Web pages where you want to show financing options without interaction |
| Financing Explorer | Live embedded widget with interactive loan amount, down payment, and duration controls | Web pages where customers should explore different financing scenarios before clicking through to onboarding |
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.