De inzichten van deze maand behandelen diverse aspecten van de koppeling van iDEAL met V-smart. Dat wordt hierna vanuit meerdere oogpunten toegelicht in drie artikelen:
- hoe werkt de koppeling
- wat is iDEAL 2.0
en
- wat is bij de overgang van belang voor u.
Wanneer wij praten over iDEAL 2.0 betreft dat in wezen twee verschillende zaken: de applicatie iDEAL an sich (waar er een nieuwe versie van is) en de (nieuwe) koppeling van dat iDEAL met V-smart. Deze twee lopen hierna en ook in de praktijk, bij gebruik, enigszins door elkaar. Gelukkig zijn de verschillen met de huidige werkwijze transparant: de klant zal niets merken van de wijzigingen.
In 2025 verandert er veel in “de wereld van iDEAL”.
Wat wij de iDEAL-koppeling noemen is doorgaans uitgebreider en is eigenlijk een koppeling met een betaalprovider. Deze verschilt vaak per land en er zijn dan ook meerdere van dergelijke koppelingen. In Nederland is dit van oudsher een koppeling met het platform van Ogone.
Het werkt zo: bij de koppeling zijn eigenlijk drie partijen betrokken (we vergeten even dat er bij een iDEAL-betaling nog een vierde is: de bank van de klant). Die drie zijn: de bank van de bibliotheek, het betaalplatform (Ogone) en Axiell. De koppeling met het betaalplatform is zoals gezegd ”uitgebreider” en omvat vaak bijv. ook PayPal en credit cards (bijv. VISA en American Express). De bank van de bibliotheek ondersteunt ook de koppeling met Ogone en zij (de bank) bepaalt welke opties worden aangeboden. Voorbeeld: alhoewel de koppeling [technisch] ook VISA ondersteunt, is dat van geen belang als de bank van de bibliotheek dat niet doet. De klant kan dan niet via VISA betalen.
Ogone was een bedrijf dat is overgenomen door Ingenico, dat op zijn beurt weer is overgenomen door de actuele eigenaar, Wordline. Deze wil de huidige koppeling vervangen door een moderner alternatief, een koppeling via een API.
Een andere grote wijziging is de overstap naar iDEAL 2.0, een nieuwe versie van de applicatie. Hierover leest u hierna meer in “Stap moeiteloos over naar iDEAL 2: de nieuwste versie in uw bibliotheekapplicatie”.
Er is nog een derde wijziging (aan de V-smart-kant): de overgang van een techniek die CSP heet (Caché Server Pages),) naar CLS (classes).
Deze twee wijzigingen, de CLS-techniek enerzijds en de API-koppeling anderzijds, staan in de praktijk (voor V-smart) niet geheel los van elkaar. Wij zullen deze namelijk gelijktijdig installeren. Het zal onmogelijk zijn slechts één van beide te krijgen. De overgang naar iDEAL 2.0 staat hier los van en wordt volledig door Wordline bepaald, maar in de praktijk is dit de actuele versie die klanten te zien krijgen.
Als wij praten over de koppeling met iDEAL 2.0 betekent dat dus eigenlijk meerdere zaken: de nieuwe versie met de functionele nieuwigheden in iDEAL, de nieuwe CLS-techniek en de nieuwe koppelingsmethodiek via API. Van deze laatste twee zal de klant echter niets merken.
De overgrote meerderheid van online betaaltransacties die in Nederland gebeuren verlopen via iDEAL, al helemaal als het gaat om “micro-betalingen” (van kleine bedragen dus). Jaarlijks worden er meer dan 1 miljard transacties verwerkt en vele Nederlandse banken (o.a. de grote drie – ABN AMRO, ING en Rabobank) ondersteunen het protocol.
iDEAL kan met V-smart en Iguana worden gekoppeld via het Ogone-protocol, dat eigendom is van de betaalprovider (Payment Service Provider) Worldline.
Sinds enige tijd is iDEAL 2.0 beschikbaar. Deze nieuwigheden in deze versie zijn an sich voor V-smart niet bijster interessant; iets anders is dat wel: de koppeling verloopt (als wij praten over iDEAL 2.0) -technisch- geheel anders.
Hoe het zit
Technisch is de koppeling eigenlijk geen koppeling met iDEAL, maar met een betaalplatform. De banken hebben ook een koppeling met het betaalplatform en zij bepalen in wezen welke betaalmethodes worden ondersteund (naast iDEAL zijn dat vaak ook credit cards [VISA, MasterCard, …] en PayPal). De oorspronkelijke ontwikkelaar van het betaalplatform waarmee V-smart koppelt was Ogone. Dat bedrijf is later overgenomen door Ingenico, dat op zijn beurt weer overgenomen werd door Worldline. Dit laatste bedrijf wil nu af van de manier waarop de koppeling technisch verloopt; er komt een nieuwe koppeling.
De nieuwe koppeling verloopt via API’s en wij zullen deze ondersteunen. Alle V-smartgebruikers zullen dus moeten overschakelen naar deze nieuwe methode, want ondersteuning voor de huidige methode eindigt op 31 december 2025.
Wat is er nieuw in iDEAL 2.0?
De voornaamste functionele nieuwigheden die in de (verbeterde) versie 2.0 (door WorldLine) worden aangeprezen (maar die niet alle relevant zijn in de context van V-smart) zijn:
- Ondersteuning voor betalingen via QR-codes
- Verbeterde beveiliging (via nieuwe, meer geavanceerde beveiligingsprotocollen)
- Beschikbaar voor extra banken en betaalproviders
- Snellere verwerkingstijden
- Grotere gebruiksvriendelijkheid (een betere gebruikersinterface, o.a. door de introductie van profielen; het grote voordeel is dat stappen die al eerder gezet zijn niet steeds weer herhaald hoeven te worden)
- Voldoet aan Europese wetgeving
Meer informatie vindt u op de links onderaan deze pagina.
Het doel is in essentie tweeledig: een grotere tevredenheid bij zowel de klant (“makkelijker” en “sneller”) als bij de verkoper (“meer”).
In wezen zijn er dus twee grote wijzigingen: nieuwe functionaliteit aan de kant van iDEAL (zie hiervoor) en een nieuwe koppeltechniek (aan zowel de kant van iDEAL als die van V-smart en Iguana).
Axiell kan bibliotheken die vanuit V-smart met de iDEAL-functionaliteit koppelen op eenvoudige wijze omzetten naar deze nieuwe versie. De producten zijn hierop al aangepast; wel moet de configuratie worden gewijzigd. Er gaan geen kosten voor Axiell mee gepaard.
Zie ook hierna.
Een nieuw soort techniek
Onder de motorkap verloopt de 2.0-koppeling via een geheel andere techniek. Dit betreft vooral de nieuwe API-koppeling, die verloopt via het nu erg in zwang zijnde REST/JSON-protocol.
Bovendien is ook de gebruikte techniek aan de Axiellkant gewijzigd. Waar dit voorheen (aan de kant van V-smart en Iguana) verliep via CSP (Caché Server Pages), gaat het nu om CLS (classes). Dit is echter interne keuken, want de oplossing blijft in wezen een combinatie van HTML, Javascript, Caché Object Script en CSS (Cascading Style Sheets).
Hoe neemt u iDEAL 2.0 in combinatie met V-smart in gebruik?
Om iDEAL 2.0 in combinatie met V-smart in gebruik te nemen gaat u als volgt te werk (we gaan er hier van uit dat u over een werkende iDEAL-koppeling beschikt).
Axiell zal de software aanpassen en uw aandeel blijft beperkt tot het “aanvragen” van de koppeling en een (kleine) aanpassing in de configuratie.
Om de service niet te onderbreken moet dit dus gebeuren na de update van de software en sowieso vóór 31 december 2025.
De nieuwe “Worldline (Ogone) direct API integration” vervangt de huidige implementatie van de legacy Worldline software, die niet meer ondersteund wordt na 31 december 2025.
De gebruikte integratiemethode is de “Worldline Hosted Checkout Page method”.
U moet op twee plaatsen de configuratie aanpassen: in Wordline en in V-smart.
Wat u moet doen in Wordline
In de backoffice van Worldline moet u drie dingen doen:
- Activeer de DIR (Merchant using Direct Integration)
- Genereer de API-sleutel
- Genereer het “geheim”.
2 en 3 moeten worden ingesteld in V-smart AFO 497 – Financiële groepen – Instellingen voor Ogone/iDEAL.
Wat u moet doen in V-smart
Stel in “AFO 497 > Opties voor creditcardbetalingen” de URL voor het opstartscherm in (xxx/Payment.Payment.Start.cls) – de syntax is doorgaans https://webserver/servicesapp/Payment.Payment.Start.cls
Stel in “AFO 497 > Financiële groepen > Instellingen voor Ogone/iDEAL” de volgende instellingen in:
- Response-URL (WorldLine stuurt de betalingsstatus naar deze URL) – de vereiste syntax is https://webserver/servicesapp/Payment.Payment.ReceiveWORLDLINEAPI.cls
- URL van de serviceprovider – de vereiste syntax voor de WorldLine-productieomgeving is https://payment.direct.worldline-solutions.com/v2 en voor de testomgeving https://payment.preprod.direct.worldline-solutions.com/v2
- WorldLine API-sleutel en WorldLine API-geheim zoals gedefinieerd in (verkregen van) de Worldline Back Office of in de Worldline Merchant Portal
- Toon WorldLine-resultatenpagina – dit is een optionele pagina aan de kant van WorldLine
- Toon pagina ‘Betaling geaccepteerd’ – deze pagina aan de kant van V-smart toont de resultaten van een geaccepteerde betaling en is nu optioneel. (Houd er rekening mee dat er een fout-/annuleringspagina altijd wordt weergegeven.)
Nog meer praktijk
U zult nadere instructies en informatie over de migratie ontvangen voorafgaand aan de overgang. Neem in geval van twijfel contact op met uw accountmanager.
Meer
Meer informatie over iDEAL en iDEAL 2.0 vindt u o.a. hier:
https://www.ideal.nl/het-nieuwe-ideal
https://linkpay.nu/wat-is-ideal-20-hoe-werkt-het
Zie ook:
https://www.axiell.com/nl/blog-post/betalen-op-de-vertrouwde-manier-pinnen-en-ideal/
De koppeling met de zgn. “payment provider” is vaak landgebonden. Zo zijn er ook koppelingen met bijv. BucksNet en PayFip.
