LeaseModule Portaal – iframe
Handleiding iframe

Iframe-integratie voor portalen en klantwebsites.

Gebruik je portaalintegratie en de dealer-ID van de betreffende klant. Bekijk de voorbeelden voor voertuigdetailpagina’s, maandprijskaarten en financieringspagina’s. De opmaak en breedte sluiten nu aan op de nieuwste handleidingsstijl.

Onderdelen in deze handleiding

Leasecalculator bij een voertuig · Maandprijs · Losse calculator · Leasevoorraad (optioneel) · Leaseprofiel.

Overzicht

Met één integratie-ID kun je drie soorten iframe-weergaven plaatsen. Kies per pagina het juiste type en vul de voertuiggegevens dynamisch vanuit jouw website in.

01

Voertuigcalculator

Volledige calculator op de voertuigdetailpagina met aanvraagmogelijkheid.

GESCHIKT VOOR: DETAILPAGINA’S
02

Maandprijs voertuig

Compact maandbedrag op een voertuigkaart of naast de verkoopprijs.

GESCHIKT VOOR: AANBODSKAARTEN
03

Losse calculator

Algemene calculator waarbij de bezoeker zelf de voertuiggegevens invoert.

GESCHIKT VOOR: FINANCIERINGSPAGINA’S

Voorbeeld aanpassen en lokaal testen

Alleen de integratie-ID vervangen is niet voldoende. Pas deze drie waarden aan voordat je een voorbeeld gebruikt:

ParameterJouw waarde
integration_idUitsluitend de integratie-ID uit de aansluitmail. Kopieer geen tekst zoals “API-key eindigt op …” mee.
originHet exacte adres van de website waarin het iframe staat: protocol, domein en eventuele poort, zonder pad. Voorbeeld.nl is een invulvoorbeeld en is niet automatisch toegestaan. Externe websites moeten geregistreerd en actief zijn.
dealer_idDe actieve dealer-ID van de betreffende klant binnen jouw portaal. LO-00002 is slechts een voorbeeld; gebruik jouw eigen overzicht.

Lokaal testen

Voor iframes zijn localhost en 127.0.0.1 via HTTP en HTTPS met elke poort automatisch toegestaan bij actieve integraties. Aanmelden als klantdomein is hiervoor niet nodig. Gebruik een lokale webserver, geen file://. De integratie, het onderdeel en de dealer-ID moeten wel actief zijn.

Dit voorbeeld gaat uit van http://localhost:3000. Pas de poort aan jouw omgeving aan en vervang beide ID’s. De geregistreerde dealerwebsite blijft de echte klantwebsite.

<iframe src="https://leasemodule.nl/api/embed/?integration_id=JOUW_INTEGRATIE_ID&origin=http%3A%2F%2Flocalhost%3A3000&type=standalone&dealer_id=JOUW_DEALER_ID" title="Leasecalculator" width="100%" height="650" style="border:0;width:100%"></iframe>

Voor een live website gebruik je bij origin het geregistreerde websiteadres, bijvoorbeeld https%3A%2F%2Fwww.klant.nl. De URL moet correct worden gecodeerd, bijvoorbeeld met encodeURIComponent(window.location.origin). Een geheime API-key hoort nooit in het iframe.

Foutmeldingen

  • Dit domein is niet toegestaan: controleer origin; laat voorbeeld.nl niet staan. Controleer protocol, www en poort.
  • Ongeldige integratie-ID: kopieer uitsluitend de ID.
  • Dealer-ID niet actief: controleer de dealer-ID en de actieve klant binnen dit portaal.
  • 422 bij vehicle/monthly: aanschafprijs moet groter dan nul zijn; merk en model zijn verplicht. Geef een prijs als 24950 of 24950.50 mee, zonder valutateken of duizendtalscheiding. Bij andere API-verzoeken lees je de JSON-foutdetails.
  • 403 Forbidden of Unexpected token <: controleer de HTTP-response. Een HTML-foutpagina is geen JSON. Neem contact op met de beheerder; voor iframe- en API-mappen moet index.php bereikbaar zijn.

De lokale uitzondering geldt voor iframes. Rechtstreekse REST API-verzoeken vanuit een backend blijven een API-key vereisen. Een testaanvraag wordt normaal verwerkt en kan e-mails versturen.

Voordat je begint

Openbaar

Integratie-ID

Deze ontvang je van jouw leaseprovider. De integratie-ID mag zichtbaar zijn in de iframe-URL.

Benodigd

Dealer-ID

Gebruik de dealer-ID uit jouw eigen dealer-ID-overzicht, bijvoorbeeld LO-00002.

i
BelangrijkGebruik alleen de onderdelen die voor jouw portaal actief zijn. Voor voertuig- en maandprijsweergaven vul je de voertuiggegevens automatisch per advertentie in.

1. Voertuigcalculator

Toon op de voertuigdetailpagina de volledige calculator naast of onder het geselecteerde voertuig.

Voorbeeld van de voertuigcalculator op een voertuigdetailpagina
Voorbeeld van de voertuigcalculator op een voertuigdetailpagina

Voertuigcalculator

Volledige calculator op de voertuigdetailpagina, inclusief voertuiggegevens en een duidelijke aanvraagknop.

Bereken jouw leasebedrag

Aanschafprijs: € 24.950
Looptijd: 72 maanden
Aanbetaling: € 0
Bereken maandbedrag

Illustratieve weergave van de calculator naast een voertuigdetail.

Voorbeeldcode
<iframe id="lm-vehicle" src="https://leasemodule.nl/api/embed/?integration_id=JOUW_INTEGRATIE_ID&origin=https%3A%2F%2Fvoorbeeld.nl&type=vehicle&dealer_id=LO-00002&reference=VWE12345&aanschafprijs=24950&voertuigsoort=Personenauto&merk=Volkswagen&model=Golf&bouwjaar=2022&kenteken=G123AB&brandstof=Benzine&btwmarge=btw&dealernaam=Voorbeeld+Autobedrijf&dealerwebsite=https%3A%2F%2Fvoorbeeld.nl&voertuigurl=https%3A%2F%2Fvoorbeeld.nl%2Faanbod%2Fgolf" title="LeaseModule vehicle" width="100%" height="450" style="border:0;width:100%" loading="lazy"></iframe>
<script>
(function () {
  var frame = document.getElementById('lm-vehicle');
  if (!frame) return;
  window.addEventListener('message', function (event) {
    if (event.origin !== 'https://leasemodule.nl' ||
        event.source !== frame.contentWindow ||
        !event.data || event.data.type !== 'leasemodule:height') return;
    var height = Number(event.data.height);
    if (isFinite(height) && height >= 100 && height <= 10000) {
      frame.style.height = Math.ceil(height) + 'px';
    }
  });
  frame.addEventListener('load', function () {
    frame.contentWindow.postMessage({type:'leasemodule:hello'}, 'https://leasemodule.nl');
  });
})();
</script>

2. Maandprijsberekening

Gebruik deze compacte variant op voorraadkaarten, bij de verkoopprijs of in een voertuiglijst.

Voorbeeld van maandprijs voertuig op een aanbodkaart

Maandprijs voertuig

Compacte weergave voor aanbodskaarten, zoekresultaten en voertuigoverzichten.

Maandprijs op kaart

Vanaf € 427 p/m
De providerinstellingen en voertuiggegevens bepalen automatisch het bedrag.
Voorbeeldcode
<iframe id="lm-monthly" src="https://leasemodule.nl/api/embed/?integration_id=JOUW_INTEGRATIE_ID&origin=https%3A%2F%2Fvoorbeeld.nl&type=monthly&dealer_id=LO-00002&reference=VWE12345&aanschafprijs=24950&voertuigsoort=Personenauto&merk=Volkswagen&model=Golf&bouwjaar=2022&kenteken=G123AB&brandstof=Benzine&btwmarge=btw&dealernaam=Voorbeeld+Autobedrijf&dealerwebsite=https%3A%2F%2Fvoorbeeld.nl&voertuigurl=https%3A%2F%2Fvoorbeeld.nl%2Faanbod%2Fgolf" title="LeaseModule monthly" width="100%" height="140" style="border:0;width:100%" loading="lazy"></iframe>
<script>
(function () {
  var frame = document.getElementById('lm-monthly');
  if (!frame) return;
  window.addEventListener('message', function (event) {
    if (event.origin !== 'https://leasemodule.nl' ||
        event.source !== frame.contentWindow ||
        !event.data || event.data.type !== 'leasemodule:height') return;
    var height = Number(event.data.height);
    if (isFinite(height) && height >= 100 && height <= 10000) {
      frame.style.height = Math.ceil(height) + 'px';
    }
  });
  frame.addEventListener('load', function () {
    frame.contentWindow.postMessage({type:'leasemodule:hello'}, 'https://leasemodule.nl');
  });
})();
</script>

3. Losse calculator

Voor een algemene financieringspagina zonder vooraf geselecteerd voertuig.

Voorbeeld van een losse calculator op een financieringspagina

Losse calculator

Zelfstandige calculator voor algemene financieringspagina’s zonder vooraf geselecteerd voertuig.

Losse leasecalculator

Aanschafprijs invoeren
Zakelijk / particulier kiezen
Looptijd selecteren
Berekenen
Voorbeeldcode
<iframe id="lm-standalone" src="https://leasemodule.nl/api/embed/?integration_id=JOUW_INTEGRATIE_ID&origin=https%3A%2F%2Fvoorbeeld.nl&type=standalone&dealer_id=LO-00002" title="LeaseModule standalone" width="100%" height="450" style="border:0;width:100%" loading="lazy"></iframe>
<script>
(function () {
  var frame = document.getElementById('lm-standalone');
  if (!frame) return;
  window.addEventListener('message', function (event) {
    if (event.origin !== 'https://leasemodule.nl' ||
        event.source !== frame.contentWindow ||
        !event.data || event.data.type !== 'leasemodule:height') return;
    var height = Number(event.data.height);
    if (isFinite(height) && height >= 100 && height <= 10000) {
      frame.style.height = Math.ceil(height) + 'px';
    }
  });
  frame.addEventListener('load', function () {
    frame.contentWindow.postMessage({type:'leasemodule:hello'}, 'https://leasemodule.nl');
  });
})();
</script>

4. Velden en parameters

Voor vehicle en monthly stuur je voertuiggegevens mee. De losse calculator heeft alleen de integratie-ID en dealer-ID nodig.

ParameterVerplichtOmschrijving
integration_idJaDe integratie-ID uit jouw e-mail.
typeJavehicle, monthly of standalone.
dealer_idJaDealer-ID uit jouw dealer-overzicht, bijvoorbeeld LO-00002.
aanschafprijsJa*Verkoopprijs als getal, bijvoorbeeld 24950.
merkJa*Merknaam, bijvoorbeeld Volkswagen.
modelJa*Modelnaam, bijvoorbeeld Golf.
kentekenOptioneelKenteken van het voertuig.
bouwjaarOptioneelViercijferig bouwjaar.
brandstofOptioneelBijvoorbeeld Benzine.
btwmargeOptioneelbtw of marge.
voertuigsoortOptioneelBijvoorbeeld Personenauto of Bedrijfswagen.
termOptioneel**Looptijd in maanden; standaard 72.
productOptioneel**business of consumer.
down_paymentOptioneel**Aanbetaling; standaard 0.
final_paymentOptioneel**Slottermijn; standaard 0.

* Alleen verplicht voor vehicle en monthly. ** Alleen beschikbaar voor de maandprijsweergave.

Leasevoorraad (optioneel)

Toon het eigen aanbod van iedere aangesloten klant, inclusief voertuigdetails en de beschikbare financieringsvormen.

Beschikbaar binnen Business en Enterprise wanneer Digifresh Leasevoorraad voor de leaseprovider heeft geactiveerd. Laat Digifresh de voorraadkoppeling inrichten. Een voorraadkoppeling gebruikt bestaande voorraad; deze importeert zelf geen voertuigen.

Jouw klantgegevens staan in de PDF-bijlage

Bij jouw aansluitmail ontvang je LeaseModule-installatieoverzicht.pdf. Hierin staan per klant de website, dealer-ID, plaatsings-ID en status. Gebruik de plaatsings-ID bij de juiste klantwebsite voor JOUW_PLAATSINGS_ID.

Staat er Nog niet ingericht? Vraag jouw leaseproviderbeheerder of Digifresh om de voorraadkoppeling. Na inrichting ontvang je een nieuwe aansluitmail met bijgewerkte PDF. Voor een direct aangesloten autobedrijf is geen dealer-ID nodig.

Eén voorraadkoppeling per klantwebsite

De portaalintegratie kan voor meerdere klanten worden gebruikt. Iedere klantwebsite krijgt een aparte voorraadkoppeling met een eigen openbare plaatsings-ID, klantnaam, exact HTTPS-domein en voorraadnummer(s). De plaatsings-ID bepaalt welke voorraad zichtbaar is; alleen de portaalintegratie-ID meesturen is niet voldoende.

GegevenFunctie
Portaalintegratie-IDKoppelt aan het portaal en de leaseprovider.
Dealer-IDIdentificeert een portaalklant bij calculatoraanvragen.
Voorraadnummer(s)Selecteren voertuigen uit de voorraadbron; niet automatisch hetzelfde als het dashboardklantnummer of de dealer-ID.
Plaatsings-IDUnieke code voor de voorraadweergave van één klantwebsite.

Voorbeeld: klant A en klant B delen de portaalintegratie, maar hebben ieder hun eigen domein, voorraadnummer(s) en plaatsings-ID. Kopieer voor iedere klant de eigen installatiecode uit Leaseaanbod. Deel geen algemene voorraadcode tussen klanten.

Voorraad plaatsen met een iframe

De installatiecode bestaat uit een HTML-element en een insluitscript. Het script maakt het iframe aan en past de hoogte automatisch aan. Plaats beide regels in een HTML-blok op de klantwebsite.

Installatiecode — vervang de voorbeeld-ID door de code van de betreffende klant
<div data-leasemodule-aanbod="JOUW_PLAATSINGS_ID"></div>
<script async src="https://leasemodule.nl/api/leaseaanbod/embed.js"></script>

Gebruik de volledige code uit Leaseaanbod → de betreffende koppeling. Het iframe mag uitsluitend op het ingestelde domein worden geplaatst. Met en zonder www zijn verschillende domeinen. Laat voor een extra domein een aparte koppeling inrichten.

Controleren vóór ingebruikname

  • Controleer dat alleen voertuigen van de juiste klant zichtbaar zijn, ook na filteren en bij het openen van een detailpagina.
  • Test foto's, filters, paginering en weergave op mobiel.
  • Vergelijk maandprijzen bij dezelfde looptijd, aanbetaling, slottermijn en btw-instelling.
  • Stem een herkenbare testaanvraag af en controleer klantnaam, website, voertuig en ontvangst bij de leaseprovider.
i
Aanvraagherkomst controlerenDe voorraadkoppeling zoekt de dealer-ID op binnen precies deze portaalintegratie en het geregistreerde klantdomein. De iframe-calculator stuurt die dealer-ID automatisch mee. Registreer de klant daarom eerst bij het portaal met een geldige dealer-ID en toegestaan domein. Bij een ontbrekende of verwijderde klantregistratie wordt de voorraadweergave geblokkeerd. Controleer een testaanvraag op de juiste dealer-ID vóór livegang.

Voertuigen die de voorraadbron als verkocht markeert krijgen geen calculator. Verwijderde voertuigen zijn niet meer te openen. Een verkoopsbanner in een foto wordt niet automatisch herkend. Een uitgeschakelde voorraadkoppeling toont geen aanbod meer.

Leaseprofiel

Plaats informatie over de leaseprovider, met bedrijfsomschrijving, maximaal vier afbeeldingen, adres, website, contactgegevens, veelgestelde vragen, een slogan en een formulier voor algemene informatievragen.

Digifresh beheert en publiceert het profiel. Klantwebsites die dezelfde leaseprovider gebruiken kunnen hetzelfde openbare profiel plaatsen. Kies bij verschillende leaseproviders steeds het profiel van de juiste provider. Het openbare Leaseprofiel-iframe vereist geen dealer-ID, integratie-ID of geheime API-sleutel. De REST API gebruikt wel jouw integratie-ID en geheime API-sleutel.

Voorbeeld — gebruik de provider-ID en volledige installatiecode van Digifresh
<iframe id="lm-leaseprofiel"
  src="https://leasemodule.nl/api/leaseprofiel/?provider_id=JOUW_PROVIDER_ID"
  title="Over onze leasepartner" width="100%" height="850"
  style="border:0;width:100%" loading="lazy"></iframe>
<script>
(function () {
  var frame = document.getElementById('lm-leaseprofiel');
  window.addEventListener('message', function (event) {
    if (event.origin !== 'https://leasemodule.nl' ||
        event.source !== frame.contentWindow ||
        !event.data || event.data.type !== 'leasemodule:height') return;
    var height = Number(event.data.height);
    if (Number.isFinite(height) && height >= 100 && height <= 20000)
      frame.style.height = Math.ceil(height) + 'px';
  });
})();
</script>

Plaats dit bijvoorbeeld op een pagina 'Over onze leasepartner'. Controleer logo's, afbeeldingen, contactknoppen en FAQ op desktop en mobiel. Gepubliceerde wijzigingen worden automatisch zichtbaar op de aangesloten websites. Algemene informatievragen via het iframe worden naar het ingestelde profiel-e-mailadres gestuurd. Het formulier vereist actieve centrale reCAPTCHA v2-instellingen en gebruikt daarnaast een honeypot. Bij REST API-weergave bouwt de website de interface zelf; de GET-profielroute verwerkt geen formulierinzendingen.

5. Installeren en testen

  • Vervang de voorbeeld-integratie-ID en dealer-ID.
  • Bouw de iframe-URL op met jouw actuele voertuiggegevens.
  • Plaats de iframe in een HTML-widget of website-template.
  • Controleer of jouw domein is toegestaan bij de leaseprovider.
  • Test berekeningen, mobiele weergave en aanvraagverwerking.
!
Let opZie je een lege iframe? Controleer de browserconsole op frame-ancestors of X-Frame-Options. Een geheime API-sleutel plaats je nooit in browsercode.