Handleiding voor autodealers

Kies jouw integratiemethode

Als autobedrijf heb je twee mogelijkheden: plaats de LeaseModule snel via een iframe op je website, of bouw een eigen interface via de REST API. Voor de meeste websites is de iframe-variant de snelste en veiligste route.

Iframe-variant

Gebruik de kant-en-klare calculator op voertuigdetailpagina’s, aanbodskaarten of een algemene financieringspagina. Je website laadt de calculator veilig via LeaseModule.

AANBEVOLEN VOOR: DE MEESTE WEBSITES

Bekijk iframe-stappen →

REST API / eigen koppeling

Gebruik de API als je een volledig eigen frontend of aanvraagstraat wilt bouwen. Berekeningen en aanvragen lopen dan server-side via jouw eigen omgeving.

AANBEVOLEN VOOR: MAATWERK

Bekijk API-uitleg →

Belangrijk Als rechtstreeks aangesloten autobedrijf werk je zonder dealer-ID. Je gebruikt dus alleen jouw integratie-ID en, bij voertuig- of maandprijsweergaven, de voertuiggegevens van je eigen website.

Overzicht

Eén LeaseModule-koppeling ondersteunt drie manieren van plaatsen.

Voertuigcalculator

Volledige zakelijke en particuliere calculator bij een specifiek voertuig.

Geschikt voor: Voertuigdetailpagina’s

Maandprijs voertuig

Compact maandbedrag op een voertuigkaart of naast de aanschafprijs.

Geschikt voor: Voorraadoverzichten

Losse calculator

Algemene calculator waarbij de bezoeker zelf voertuiggegevens invoert.

Geschikt voor: Financieringspagina’s

Wat doet jouw websitebouwer?

Geef jouw integratie-ID en websiteadres door aan jouw websitebouwer. Die plaatst de calculator in de voorraadtemplate en koppelt de prijs en overige gegevens per voertuig. Voor een algemene financieringspagina kun je de losse calculator gebruiken.

Controleer vóór oplevering minimaal een BTW-auto en een margeauto, de mobiele weergave, de berekening na wijzigen van looptijd en aanbetaling en de ontvangst van een afgesproken testaanvraag bij jouw leaseprovider.

Toegang en unieke ID

LeaseModule maakt de koppeling aan en verstrekt minimaal een unieke integratie-ID. Deze ID koppelt de website aan de juiste dealerinstellingen.

Integratie-ID Openbaar

Voor de JavaScript-widget. Mag zichtbaar zijn in de HTML en werkt uitsluitend op goedgekeurde domeinen.

API-secret Geheim

Alleen voor rechtstreekse serverkoppelingen. Nooit opnemen in HTML, JavaScript, een URL of een publieke repository.

Goedgekeurd domein

De widget wordt alleen geladen op domeinen die LeaseModule bij de integratie heeft geregistreerd.

BelangrijkEen integratie-ID is een identificatiemiddel en geen geheim wachtwoord. Een API-secret is wél geheim en mag uitsluitend server-side worden gebruikt.

Snel starten met iframe

De iframe gebruikt niet de JavaScript-widgetcode hieronder. Je ontvangt jouw integratie-ID per e-mail en plaatst een iframe op de website.

Gebruik de integratie-ID uit de e-mail van jouw leaseprovider. Controleer of jouw website als toegestaan domein is geregistreerd.
Kies de juiste variant: voertuigcalculator op een detailpagina, maandprijsberekening op een voertuigkaart of losse calculator op een financieringspagina.
Plaats de volledige iframe-code inclusief automatische hoogteaanpassing uit de aparte autodealer-iframehandleiding. Vul bij voertuig- en maandprijsweergaven de gegevens per auto dynamisch in.

Geen dealer-ID nodig Een rechtstreeks aangesloten autobedrijf gebruikt de eigen integratie-ID. Alleen portalen gebruiken daarnaast een aparte dealer-ID per klant.

Open complete iframe-handleiding →

Voertuigcalculator – JavaScript-widget

De calculator gebruikt de voertuiggegevens als uitgangspunt en toont de producten die voor deze dealer zijn geactiveerd.

HTML

<div
  class="leasemodule-calculator"
  data-type="vehicle"
  data-integration-id="YOUR-INTEGRATION-ID"
  data-reference="45142389"
  data-aanschafprijs="31950"
  data-voertuigsoort="Personenauto"
  data-merk="Audi"
  data-model="Q5"
  data-brandstof="Hybride benzine"
  data-bouwjaar="2019"
  data-kenteken="N635ZB"
  data-btwmarge="marge"
  data-dealerwebsite="https://www.abcautos.nl/"
  data-dealernaam="ABC Auto's"
  data-voertuigurl="https://www.abcautos.nl/occasions-kopen/45142389-audi-q5-45-tfsi-quattro-pro-line/">
</div>

<script src="https://leasemodule.nl/api/widget/v1/leasemodule.js?v=1.17.27" async></script>

AanbevolenHet bestand leasemodule.js slechts één keer per pagina opnemen, ook als meerdere maandprijzen worden getoond.

Maandprijs voertuig – JavaScript-widget

Gebruik deze compacte variant op een voertuigkaart of naast de aanschafprijs. Een klik kan de volledige calculator openen.

HTML

<div
  class="leasemodule-monthly-price"
  data-integration-id="YOUR-INTEGRATION-ID"
  data-reference="45142389"
  data-aanschafprijs="31950"
  data-voertuigsoort="Personenauto"
  data-merk="Audi"
  data-model="Q5"
  data-brandstof="Hybride benzine"
  data-bouwjaar="2019"
  data-kenteken="N635ZB"
  data-btwmarge="marge"
  data-dealerwebsite="https://www.abcautos.nl/"
  data-dealernaam="ABC Auto's"
  data-voertuigurl="https://www.abcautos.nl/occasions-kopen/45142389-audi-q5-45-tfsi-quattro-pro-line/">
</div>

<script src="https://leasemodule.nl/api/widget/v1/leasemodule.js?v=1.17.27" async></script>

Batch APIToont u veel voertuigen op één pagina? Gebruik dan bij een serverkoppeling het batch-endpoint en cache het resultaat. Start niet voor ieder voertuig een losse API-aanvraag.

Losse calculator – JavaScript-widget

Bij de losse calculator zijn geen voertuiggegevens verplicht in de HTML. De bezoeker voert deze zelf in. De dealerinstellingen komen uit de integratie-ID.

HTML

<div
  class="leasemodule-calculator"
  data-type="standalone"
  data-integration-id="YOUR-INTEGRATION-ID">
</div>

<script src="https://leasemodule.nl/api/widget/v1/leasemodule.js?v=1.17.27" async></script>

WordPress-plugin

Voor WordPress-websites is een basisplugin beschikbaar. Hiermee kunnen calculators zonder handmatige HTML of JavaScript via shortcodes worden geplaatst.

LeaseModule Calculator voor WordPressVersion 1.18.10 · ZIP

WordPress-plugin downloaden ↓

Installeren in WordPress

Download het ZIP-bestand via de knop hierboven.
Open in WordPress: Plugins → Nieuwe plugin → Plugin uploaden.
Selecteer leasemodule-wordpress.zip, installeer en activeer de plugin.
Open Instellingen → LeaseModule en vul de ontvangen integratie-ID en API-key in.
Sla de instellingen op en klik op Verbinding testen.

Instellingen

De integratie-ID identificeert de LeaseModule-klant. De API-key wordt uitsluitend server-side in WordPress opgeslagen en wordt niet in de openbare pagina of widget geplaatst.

✓

BeveiligingVervang bij een update de bestaande plugin via WordPress. De opgeslagen integratie-ID en API-key blijven behouden.

Beschikbare shortcodes

Voertuigcalculator

WordPress shortcode

[leasemodule_calculator
  aanschafprijs="31950"
  voertuigsoort="Personenauto"
  merk="Audi"
  model="Q5"
  brandstof="Benzine"
  bouwjaar="2021"
  kenteken="AB123C"
  btwmarge="btw"
  dealerwebsite="https://www.abcautos.nl/"
  dealernaam="ABC Auto's"
  voertuigurl="https://www.abcautos.nl/occasions-kopen/45142389-audi-q5-45-tfsi-quattro-pro-line/"]

Maandprijs voertuig

WordPress shortcode

[leasemodule_monthly_price
  aanschafprijs="31950"
  voertuigsoort="Personenauto"
  merk="Audi"
  model="Q5"
  brandstof="Benzine"
  bouwjaar="2021"
  btwmarge="btw"
  dealerwebsite="https://www.abcautos.nl/"
  dealernaam="ABC Auto's"
  voertuigurl="https://www.abcautos.nl/occasions-kopen/45142389-audi-q5-45-tfsi-quattro-pro-line/"]

Losse calculator

WordPress shortcode

[leasemodule_calculator type="standalone"]

De shortcodes kunnen ook in een Elementor Shortcode-widget of het standaard WordPress Shortcode-blok worden gebruikt.

Velden en waarden

Veld	Type	Voorbeeld	Toelichting
`aanschafprijs` Verplicht	number	`31950`	Positief getal in euro’s, zonder euroteken of duizendtallenpunt. Zakelijk wordt de prijs al exclusief btw aangeleverd; particulier is een personenauto inclusief btw en wordt bij een BTW-bedrijfswagen 21% btw toegevoegd.
`doel` Optioneel	string	`Auto`	Bij de losse particuliere calculator: Auto, Motor, Vrachtwagen, Camper, Caravan of Boot.
`voertuigsoort` Verplicht	string	`Personenauto`	Gebruik een van de vastgestelde voertuigsoorten.
`merk` Verplicht	string	`Audi`	Merknaam van het voertuig.
`model` Verplicht	string	`Q5`	Modelnaam van het voertuig.
`brandstof` Verplicht	string	`Hybride benzine`	Gebruik een van de vastgestelde brandstofwaarden.
`bouwjaar` Verplicht	integer	`2019`	Bouwjaar met vier cijfers.
`kenteken` Optioneel	string	`N635ZB`	Kenteken; spaties en streepjes worden bij voorkeur vooraf verwijderd.
`btwmarge` Verplicht	string	`marge`	Vaste waarde: btw of marge.
`dealerwebsite` Verplicht	url	`https://www.abcautos.nl/`	Volledige HTTPS-URL van de algemene website van het autobedrijf.
`voertuigurl` Verplicht	url	`https://www.abcautos.nl/occasions-kopen/45142389-audi-q5-45-tfsi-quattro-pro-line/`	Volledige HTTPS-URL van de detailpagina waarop het gekozen voertuig staat.
`dealernaam` Optioneel	string	`ABC Auto's`	Naam van het autobedrijf. Centraal ingestelde gegevens blijven leidend.
`dealerplaats` Optioneel	string	`Amsterdam`	Vestigingsplaats van het autobedrijf.
`dealeremail` Optioneel	email	`info@abcautos.nl`	Bij voorkeur centraal aan de integratie-ID gekoppeld en niet in openbare HTML geplaatst.
`reference` Optioneel	string	`45142389`	Unieke voertuigreferentie binnen het systeem van de dealer.

Toegestane vaste waarden

Veld	Toegestane vaste waarden
`voertuigsoort`	`Personenauto`, `Bedrijfswagen`, `Bromfiets`, `Motorfiets`, `Vrachtwagen`, `Camper`, `Caravan`, `Brommobiel`
`btwmarge`	`btw`, `marge`
`brandstof`	`Benzine`, `CNG`, `Diesel`, `Elektrisch`, `Hybride`, `Hybride aardgas`, `Hybride benzine`, `LPG`, `LPG-G3`, `Overig`, `Waterstof`

Voor ontwikkelaars: REST API en eigen aanvraagformulier

REST API

De REST API is bedoeld voor server-to-server koppelingen en biedt volledige vrijheid in vormgeving. Gebruik hiervoor altijd HTTPS en bewaar het API-secret uitsluitend op de server.

Basis-URL

URL

https://leasemodule.nl/api/v1

Authenticatieheaders

HTTP

Authorization: Bearer YOUR-API-SECRET
X-LeaseModule-Integration: YOUR-INTEGRATION-ID
Content-Type: application/json
Accept: application/json

Endpoint	Functie
POST/calculations	Definitieve berekening voor één voertuig.
POST/monthly-prices	Compacte maandprijs voor één voertuig.
POST/monthly-prices/batch	Maandprijzen voor meerdere voertuigen in één verzoek.
POST/applications	Financieringsaanvraag indienen.
GET/widget/config	Widgetinstellingen en beschikbare producten ophalen.
GET/health	Beschikbaarheid van de API controleren.

POST /v1/calculations — Voorbeeldverzoek

JSON

{
  "aanschafprijs": 31950,
  "voertuigsoort": "Personenauto",
  "merk": "Audi",
  "model": "Q5",
  "brandstof": "Hybride benzine",
  "bouwjaar": 2019,
  "kenteken": "N635ZB",
  "btwmarge": "marge",
  "dealerwebsite": "https://www.abcautos.nl/",
  "dealernaam": "ABC Auto's",
  "voertuigurl": "https://www.abcautos.nl/occasions-kopen/45142389-audi-q5-45-tfsi-quattro-pro-line/",
  "reference": "45142389",
  "business": {
    "term": 72,
    "down_payment": 0,
    "final_payment": 0
  },
  "consumer": {
    "term": 72,
    "down_payment": 0
  }
}

Voorbeeldantwoord

JSON

{
  "success": true,
  "request_id": "req_01K2A4G7M8",
  "calculation_id": "calc_8fd329",
  "currency": "EUR",
  "business": {
    "available": true,
    "monthly_amount": 523,
    "term": 72
  },
  "consumer": {
    "available": true,
    "monthly_amount": 574,
    "term": 72
  },
  "valid_until": "2026-07-17T23:59:59+02:00"
}

Aanvragen

Gebruik bij het indienen altijd de calculation_id uit de meest recente berekening. LeaseModule retourneert een uniek aanvraagnummer waarmee de aanvraag kan worden teruggevonden.

Particuliere formulierwizardDe particuliere aanvraag in de standaardwidget bestaat uit drie schermen: persoonlijke en woongegevens, inkomensgegevens (met conditionele partnergegevens) en een controlescherm. Vorige en Volgende valideren alleen de zichtbare verplichte velden.

BelangrijkPersoonsgegevens mogen nooit in URL-parameters, data-attributen of browserlogs worden geplaatst. Verstuur aanvragen uitsluitend via een beveiligd POST-verzoek.

POST /v1/applications · JSON

{
  "calculation_id": "calc_8fd329",
  "product": "business",
  "vehicle_reference": "45142389",
  "applicant": {
    "first_name": "Jan",
    "last_name": "Jansen",
    "email": "jan@example.com",
    "phone": "+31612345678"
  },
  "company": {
    "name": "Example Mobility B.V.",
    "kvk": "12345678"
  },
  "voertuigurl": "https://www.abcautos.nl/occasions-kopen/45142389-audi-q5-45-tfsi-quattro-pro-line/"
}

Beveiliging

Controlelijst voor een betrouwbare implementatie

Gebruik uitsluitend HTTPS voor de website, widget en API.
Bewaar het API-secret buiten de webroot, bijvoorbeeld in een omgevingsvariabele.
Laat ieder productie- en testdomein vooraf door LeaseModule registreren.
Valideer voertuigvelden server-side en vertrouw niet uitsluitend op browserinvoer.
Cache voorraadoverzichten kort, maar cache nooit persoonsgegevens of aanvraagverzoeken.
Gebruik de centrale honeypot-, tijd-, limiet- en duplicaatcontrole op aanvraagformulieren.
Log request-ID’s en foutcodes, maar geen volledige persoonsgegevens of API-secrets.

Foutopsporing

Controleer bij problemen eerst onderstaande punten.

Probleem	Mogelijke oorzaak en oplossing
Widget wordt niet zichtbaar	Controleer de integratie-ID, het geregistreerde domein, de browserconsole en of leasemodule.js wordt geblokkeerd.
Geen maandprijs beschikbaar	Controleer aanschafprijs, bouwjaar, voertuigsoort en BTW/Marge. Het voertuig kan buiten de ingestelde acceptatiecriteria vallen.
401 Unauthorized	De Authorization-header ontbreekt of het API-secret is ongeldig. Vernieuw een sleutel alleen via LeaseModule.
403 Forbidden	Het domein of product is niet geactiveerd voor deze integratie-ID.
422 Validation error	Een verplicht veld ontbreekt of bevat geen toegestane waarde. Bekijk de errors-array in het antwoord.
429 Too Many Requests	Er worden te veel verzoeken verstuurd. Gebruik caching, het batch-endpoint en respecteer Retry-After.

✓

DebugNoteer bij contact met LeaseModule altijd de request_id uit het API-antwoord. Deel nooit het API-secret.

Ondersteuning

Komt u er niet uit? Neem contact op met LeaseModule en vermeld de integratie-ID, het betreffende domein, de pagina-URL, het tijdstip en de request-ID.

Een leasecalculator op jouw eigen website

Kies jouw integratiemethode

Iframe-variant

REST API / eigen koppeling

Overzicht

Voertuigcalculator

Maandprijs voertuig

Losse calculator

Wat doet jouw websitebouwer?

Toegang en unieke ID

Integratie-ID Openbaar

API-secret Geheim

Goedgekeurd domein

Snel starten met iframe

Alternatief: bestaande JavaScript-widget

Voertuigcalculator – JavaScript-widget

Maandprijs voertuig – JavaScript-widget

Losse calculator – JavaScript-widget

WordPress-plugin

Installeren in WordPress

Instellingen

Beschikbare shortcodes

Velden en waarden

Toegestane vaste waarden

REST API

Basis-URL

Authenticatieheaders

POST /v1/calculations — Voorbeeldverzoek

Voorbeeldantwoord

Aanvragen

Beveiliging

Foutopsporing

Ondersteuning