Handleiding integratie FietsDirectPlan op externe websites
Versie 1.1.
Inleiding FietsDirectPlan biedt u de mogelijkheid het FietsDirectPlan te vermelden op uw website. Afhankelijk van uw situatie bieden wij 3 verschillende mogelijkheden aan om het FietsDirectPlan te integreren in uw website.. Dit document helpt de eigenaar (of degene die beslist over de inhoud van de website) met het maken van een aantal keuzes m.b.t. de integratie van het FietsDirectPlan. Zodra deze keuzes duidelijk zijn, kan de programmeur aan de hand van ditzelfde document beginnen met de technische integratie van FietsDirectPlan.
Keuzes m.b.t. de integratie van FietsDirectPlan U bepaalt zelf hoever u wilt gaan met de integratie van het FietsDirectPlan. Houdt er echter rekening mee dat de kans op meer omzet hoger zal zijn als u het FietsDirectPlan duidelijk vermeld op de website.
Er zijn drie vormen van integratie afhankelijk van uw website en uw wensen: Optie 1) Website zonder webshop Optie 2) Website met webshop – betaling in de winkel Optie 3) Website met webshop – betaling op de site
Uitleg optie 1) Website zonder webshop Eenvoudige integratie betekent dat u een tekst over het FietsDirectPlan, een logo en een link naar de FietsDirectPlan‐website op uw website plaatst. Werkzaamheden bij integratie optie 1: Als u kiest voor eenvoudige integratie is de kans groot dat u geen programmeur aan het werkt hoeft te zetten, maar dat degene die de inhoud van de website voor u aanpast, dit voor u kan uitvoeren. Een voorbeeld van integratie optie 1: Een voorbeeld van een website die gekozen heeft voor eenvoudige integratie is: http://www.vaningentweewielers.nl/Financiering.aspx Tekst/ afbeeldingen te gebruiken bij integratie optie 1: In bijlage 1 Teksten en afbeeldingen vindt u de informatie die u kunt gebruiken voor integratie op uw website.
Uitleg integratie optie 2) Integratie in webshop – betaling in de winkel Als u een website heeft inclusief een webshop, maar de betaling altijd in de winkel wordt gedaan levert FietsDirectPlan u een oplossing op maat. FietsDirectPlann levert een I‐frame voorzien van alle informatie, welke voldoet aan alle wettelijke normen. Middels dit I‐frame kan de consument informatie krijgen, de instructie video bekijken en direct een FietsDirectPlan aanvragen. De klant krijgt vervolgens een FietsDirectPlan kaart thuisgestuurd, waarmee in de winkel kan worden afgerekend. A) Uitleg over integratie optie 2: Integratie optie 2 gaat er van uit dat u het FietsDirectPlan niet integreert in uw betaalproces. Het informeren over, en het aanvragen van het FietsDirectPlan is een los staand proces binnen uw website. Als u kiest voor integratie optie 2 kunt u ook een gedeelte van de werkzaamheden van optie 1 uitvoeren door bijvoorbeeld een tekst over het FietsDirectPlan en een link naar de website te plaatsen. Integratie van het FietsDirectPlan in uw webshop betekent dat u bij de prijzen van de producten op uw website een tekst/ of banner over FietsDirectPlan en de mogelijkheid tot betalen in termijnen plaatst. (zie voorbeeld) Raadzaam is om op de detailpagina van het product de volgende link op te nemen: Gespreid betalen mogelijk met FietsDirectPlan. Deze link verwijst door naar een I‐frame overlayer, waar de klant een berekening kan maken. Bij de link plaatst u ook verplicht het logo van Let op Geld Lenen kost Geld! (zie bijlage 1) Let op! Het niet vermelden van Let op Lenen kost Geld is strafbaar!
Door de link “gespreid betalen met FietsDirectPlan”aan te klikken opent zich dan de volgende pagina:
Naast de link naar de overlayer levert FietsDirectPlan nog een ander I‐Frame, welke alle noodzakelijke informatie betreffende FietsDirectPlan bevat alsmede de mogelijkheid tot het maken van berekeningen en direct aanvragen.
Het uitgebreide FietsDirectPlan I‐frame kunt u plaatsen onder het menu‐item gespreid betalen op uw eigen site. Tevens is het raadzaam in het geval er in de webshop wel bestellingen gedaan kunnen worden, maar niet kan worden betaald het I‐frame op te nemen in de bestelmodule. U kunt hiervoor bijvoorbeeld een knop plaatsen: “ gespreid betalen aanvragen” of “FietsDirectPlan aanvragen”. De consument kan dan reeds bij zijn bestelling het FietsDirectPlan aanvragen, zodat hij bij aflevering in de winkel met zijn FietsDirectPlan kaart kan betalen.
B) Technische werkzaamheden bij integratie optie 2: Als u kiest voor integratie optie 2 zult u een programmeur in moeten schakelen, om per product een link met informatie te plaatsen. I‐frames bij integratie optie 2: Bij integratie optie 2 maakt u gebruik van de volgende i‐frames: 1) Overlayer I‐frame: http://www.fietsdirectplan.nl/berekenen/informatiepagina.cfm?nNewPageID=51&nPrice=10 00 2) I‐frame informatie & aanvraagformulier: https://secure.ficon.nl/berekenen/wallet.cfm?cRef=FDP&nPrice=1000#!cSubPage=step1 URL‐variabelen aan aanvraagformulier: cRef: Deze waarde staat vast: FDP. nPrice: De prijs van het product (numeriek veld). VrijblPrice: Deze URL‐variabele toevoegen zorgt er voor dat uw klant de prijs ook nog aan kan passen. Als u dit weg laat staat de prijs vast in het aanvraagformulier. (bijv. https://secure.ficon.nl/berekenen/wallet.cfm?cRef=FDP&nPrice=100 0&nWebShopID=UWWEBSHOPID&VrijblPrice#!cSubPage=step1 #!cSubPage: (hoofdlettergevoelig!, met dit veld kunt u bepalen op welke stap de klant binnenkomt. step1: Informatie‐pagina step2: Voorwaarden‐pagina step3: Rekenmodule step4: Aanvraagformulier Aan zowel de pagina Aanvragen van het I‐frame als ook de overlayer pagina kan uw programmeur bij het aanroepen van de pagina (via de URL) de prijs van het product doorgeven. Hierdoor krijgt de klant zowel in de informatiepagina als in het aanvraagformulier direct de juiste gegevens en het maandbedrag te zien. De url‐variabelen: &nPrice=1000 toevoegen aan de URL zorgt er voor dat het aanvraagformulier en de informatiepagina direct op 1000 euro staat. In bijlage 1: Teksten en afbeeldingen vindt u de informatie die u kunt gebruiken voor de integratie op uw website.
Uitleg integratie optie 3) Integratie in webshop – betaling in de webshop Als u een website heeft inclusief een webshop en de betaling direct in de webshop wordt verricht door de consument dan levert FietsDirectPlan u een oplossing op maat. FietsDirectPlann levert een I‐frame voorzien van alle informatie, welke voldoet aan alle wettelijke normen. Middels dit I‐frame kan de consument informatie krijgen, de instructie video bekijken en direct een FietsDirectPlan aanvragen. Uw website geeft de order direct door aan FietsDirectPlan en als de aanvraag is goedgekeurd ontvangt u daarvan bericht, zodat u de producten kunt uitleveren. FietsDirectPlan betaalt op hetzelfde moment direct het orderbedrag uit aan de webshop. De klant krijgt tevens een FietsDirectPlan kaart thuisgestuurd, waarmee vervolg aankopen direct in de winkel of online kunnen worden afgerekend. Uitleg over integratie optie 3: Bij verregaande integratie voert u alle werkzaamheden van integratie optie 2 uit, maar integreert u het FietsDirectPlan ook in het volledige bestel en betaalproces op uw website. Dit houdt in dat het FietsDirectPlan, naast bijv. Ideal of creditcard één van de betaalmogelijkheden in uw webwinkel wordt. Hierin kennen wij twee mogelijkheden: Mogelijkheid 1) U maakt gebruik van een standaardpagina (i‐frame) van een paymentprovider. Mogelijkheid 2) U heeft zelf een pagina ontwikkelt waarin u de verschillende betaalmogelijkheden verwerkt heeft. Omdat u bij mogelijkheid 1 geen invloed heeft op de inhoud van de pagina van de paymentprovider dient u een stap/ pagina in uw betaalproces toe te voegen. In deze stap geeft u de klant twee opties: A) Wilt u betalen met Ideal, Creditcard etc. klik hier. deze optie leidt naar de huidige pagina van de paymentprovider. B) Wilt u gespreid betalen met FietsDirectPlan, klik hier. deze optie leidt naar een pagina met het I‐frame van FietsDirectPlan Bij mogelijkheid 2 bepaalt u zelf hoe u de FietsDirectPlan betaaloptie integreert in de webpagina. Het I‐frame van FietsDirectPlan dat wordt aangeroepen bij de betaalopties biedt de klant twee keuzes: voor bestaande klanten inloggen en direct betalen vanuit het bestaande FietsDirectPlan voor nieuwe klanten een FietsDirectPlan aanvragen
De eerste groep klanten heeft van ons inlogcodes gekregen. Met deze inlogcodes kunnen deze klanten inloggen op hun account en direct online, realtime op uw website een bestelling plaatsen en de betaling verrichten. De tweede groep klanten moet bij ons nog een aanvraag indienen en het acceptatieproces doorlopen. Bij deze klanten zijn wij niet in staat om direct online en realtime een akkoord op een betaling te geven. Het akkoord op dit soort bestellingen/ betalingen kan dagen of weken op zich laten wachten (de snelheid is afhankelijk van de snelheid waarmee de klant de stukken naar ons retour stuurt). Om met name deze bestellingen van deze tweede groep te volgen hebben wij een XML‐functie ontwikkelt waarmee u als webshop de status van de aanvraag/ betaling bij ons op kunt halen. Deze XML‐functie (GetOrderStatus) stelt u in staat om geautomatiseerd vanuit uw eigen backoffice uw klanten op basis van bepaalde FietsDirectPlan‐statuswijzigingen zelf e‐mails te versturen of andere processen automatisch in gang te zetten.
B) Technische werkzaamheden bij integratie optie 3: Als u kiest voor integratie optie 3 zult u een programmeur in moeten schakelen, om per product een link met informatie te plaatsen. Tevens dient de programmeur het FietsDirectPlan als betaaloptie toe te voegen in de webshop. I‐frames bij integratie optie 3 Bij integratie optie 3 maakt u gebruik van de volgende i‐frames: 1) Overlayer I‐frame: http://www.fietsdirectplan.nl/berekenen/informatiepagina.cfm?nNewPageID=51&nPrice=10 00 2) I‐frame informatie & aanvraagformulier: Zie voor info over dit I‐frame de beschrijving bij Gemiddelde integratie. 3) Aanvraagformulier na betaalkeuze Wallet in betaalproces van de webshop: https://secure.ficon.nl/berekenen/wallet.cfm?cRef=FDP&uID=RETOURONTVANGENUID#!cSu bPage=step0 URL‐variabelen aan aanvraagformulier: cRef: Deze waarde staat vast: FDP. uID: Dit uID krijgt u retour zodra u de Formpost‐functie AddCustomerWithOrderItem aangeroepen heeft. #!cSubPage: (hoofdlettergevoelig!). Deze waarde staat hier vast: step0. step0 leidt naar een pagina waarop de klant de keuze krijgt XML/ formpost‐functies bij verregaande integratie Bij gemiddelde integratie maakt u gebruik van de volgende XML‐functies: 1) AddCustomerWithOrderItem (FormPost‐functie). 2) GetOrderStatus (XML‐functie). Zie bijlage 2: Uitleg XML / Formpost‐functie In bijlage 1: Teksten en afbeeldingen vindt u de informatie die u kunt gebruiken voor de integratie op uw website.
Bijlage 1) Teksten en afbeeldingen A) Logo van FietsDirectPlan: Het logo van het FietsDirectPlan kunt u hier downloaden: http://www.fietsdirectplan.nl/newimages/all_header_logo.png Wij verzoeken u het logo te laten linken naar http://www.fietsdirectplan.nl B) Afbeelding Let op Lenen kost geld: De afbeelding voor Let op! Lenen kost geld kunt u hier downloaden: http://www.fietsdirectplan.nl/newimages/fietsdirectplan_letoplenenkostgeld.jpg C) Tekst over FietsDirectPlan: FIETSDIRECTPLAN, MAAKT FIETSEN MOGELIJK! Met FietsDirectPlan kunt u uw nieuwe fiets en alle accessoires gespreid betalen. FietsDirectPlan is een flexibele betaaloplossing waarbij u zelf bepaalt in hoeveel termijnen u gespreid wilt betalen. Zo beslist u zelf wat u maandelijkse kosten zijn. Meer informatie over FietsDirectPlan AANVRAGEN Als u eenmaal een fiets van uw keuze heeft gevonden bij de fietsenwinkel kunt u op FietsDirectPlan zelf uw FietsDirectPlan aanvragen zonder verdere tussenkomst van de winkel. U kunt in alle rust een berekening maken om te komen tot een maandtermijn, waarmee u tevreden bent. Direct een berekening maken BETALEN Het betalen van uw nieuwe fiets doet u met uw persoonlijke FietsDirectPlan Card gewoon bij de fietsenwinkel. U krijgt hiervoor na goedkeuring van uw FietsDirectPlan aanvraag een op naam gestelde FietsDirectPlan Card thuisgestuurd samen met een PIN code. U betaalt met de kaart net als dat u gewend bent te betalen met uw PIN-pas. Na betaling met uw FietsDirectPlan Card rijdt u op uw nieuwe fiets de winkel uit. ALTIJD DIRECT TOEGANG TOT UW FIETSDIRECTPLAN U ontvangt bij uw FietsDirectPlan een inlognaam en wachtwoord voor de FietsDirectPlan website. Met deze inloggegevens kunt u inloggen op uw eigen FietsDirectPlan. U heeft hier inzage in uw bestedingslimiet, verrichte betalingen en uw te betalen maandtermijn. Wilt u uw maandtermijn verlagen of verhogen dan kunt u dat hier gemakkelijk zelf online aanpassen. Flexibiliteit staat voorop!
De afbeelding voor Let op! Lenen kost geld kunt u hier downloaden: http://www.fietsdirectplan.nl/newimages/fietsdirectplan_letoplenenkostgeld.jpg Deze afbeelding MOET altijd vermeld worden!
Bijlage 2) Uitleg XML/Formpost‐functies A) Uitleg Formpost‐functie AddCustomerWithOrderItem a. De basis‐url voor de functie AddCustomerWithOrderItem is https://secure.ficon.nl/AutoozXML/FiConRX.cfm Voorbeeldcode in Coldfusion:
Veldnaam Standaardwaar Omschrijving Verplicht Veldtype de uWebShopID N.v.t. Het webshopID dat u van ons Ja Guid ontvangen heeft cCommand AddCustomer Commando van formpost‐ Ja String WithOrderItem functie cInitials N.v.t. Voorletters klant Ja String cMiddleName N.v.t. Evt. tussenvoegsels klant Nee String cLastName N.v.t. Achternaam klant Ja String cStreet N.v.t. Straatnaam klant Ja String nHouseNumber N.v.t. Huisnummer + evt. Ja String toevoeging nPostcodeNumber N.v.t. Cijfers postcode klant Ja Numeriek cPostcodeLetters N.v.t. Letters postcode klant Ja String cGender Man of Vrouw Geslacht klant Ja String cPhoneNumber N.v.t. Telefoonnummer klant Ja Numeriek cEmailAddress N.v.t. Emailadres klant Ja Emailadres cRegistrationNum N.v.t. Evt. kenteken van een Nee String ber voertuig cOrderNumber N.v.t. Door uw systeem Ja String gegenereerd uniek ordernummer. nOrderAmount N.v.t. Totaalbedrag van de order Ja Numeriek cItemDescription N.v.t. Omschrijving van de order Ja String nDuration N.v.t. Evt. door klant eerder Nee Numeriek gekozen looptijd.
B) Uitleg XML‐functie GetOrderStatus https://secure.ficon.nl/WebShop/webshop.cfm?uWebShopID=B3393D04‐29AF‐4B5D‐B639‐ 5BCFD52AA5C9&cCommand=GetOrderStatus&cOrderNumber=123456&cOutPutType=xml uWebShopID : Het WebshopID dat vermeldt staat in het begeleidende e‐ mailbericht. cCommand: Dit veld staat vast: GetOrderStatus cOrderNumber: Dit is het unieke ordernummer dat u heeft doorgegeven bij AddCustomerWithOrderItem voor die betreffende order. &cOutPutType: Dit veld staat vast: XML.
