Handleiding ideal Professional

Transcriptie

1 Aanvulling voor Rabobank acceptanten op ideal Merchant Integratie Gids samengesteld door: Rabobank Nederland Versie 1.1, MEI 2012 Copyright 2010, Rabobank Nederland

2 Versie historie Versie Wijzigingen Datum 1.0 Initiële versie met bank specifieke informatie voor Rabobank ideal Professional als aanvulling op het generieke document ideal Merchant Integratie Gids. 1.1 Toevoeging nieuwe gateway adres voor protocol 25/02/ /05/2011 Copyright 2010, Rabobank, versie 1.1, Mei 2012, 2

3 1 Inleiding Wat is ideal Professional? Ondersteuning 4 2 Aanmeldproces Aanmelden via het Rabo ideal Dashboard Inloggen op de TEST omgeving Testcertificaat uploaden Uitvoeren van testtransacties Productiecertificaat uploaden Live Beveiliging Certificaten en fingerprint Genereren van RSA sleutels URL 10 3 Verplichtingen Rabo ideal Professional Ontvangen betalingen voor derden Gebruik merchant ID en SUB- ID s Leverplicht Geldigheidsduur betaling Betaalstatus navraagplicht Controleer uw aansluiting op ideal 12 4 Eisen aan de huisstijl Merk Betaalmethode, bankselectie en betaalknop 13 Copyright 2006, Rabobank, versie 1.0, Februari 2010, 3

4 1 Inleiding Dit document bevat Rabobank specifieke aanvullingen op de generieke ideal Merchant Integratie Gids en is bedoeld voor gebruik door acceptanten en/of betrokken webontwikkelaars. De tien stappen voor aanmelding en aansluiting op ideal worden toegelicht in hoofdstuk 2. Als u gebruik maakt van een reeds (door anderen) ontwikkelde koppeling met ideal Professional heeft u voldoende aan de informatie uit dit beknopte document en kunt u de ideal Merchant Integratie Gids verder negeren. Als u zelf een koppeling met ideal wenst te ontwikkelen en of u meer gedetailleerde, technische, informatie over de werking van ideal nodig heeft, adviseren wij u dringend om daar de ideal Merchant Integratie Gids bij te gebruiken. NB: vanaf de start van ideal tot begin 2010 heeft de Rabobank ook specifieke voorbeeld-software ter beschikking gesteld. Gezien de op dit moment wijdverbreide kennis inzake de integratie met ideal wordt deze voorbeeld-software niet meer verstrekt. 1.1Wat is ideal Professional? De belangrijkste kenmerken van ideal Professional zijn: - De communicatie vindt, voor zover het mogelijk is, plaats binnen uw eigen website. - Door het beveiligd ontvangen van de eindstatus is ideal Professional uitermate geschikt voor tijdgebonden leveringen, online én offline leveringen 1.2Ondersteuning Door de grote verscheidenheid aan webwinkelomgevingen is het niet mogelijk om technische ondersteuning bij de integratie van ideal Professional te bieden. De beschikbare documentatie blijkt in de praktijk goed in de informatiebehoefte te voorzien. Heeft u toch nog een vraag, suggestie of opmerking dan kunt u ons bereiken door een ticket in te sturen in het Rabo ideal Dashboard ( ). Als alternatief voor het zelf ontwikkelen van een koppeling met ideal kunt u ook overwegen om gebruik te maken van één van de vele bedrijven die een koppeling met ideal aanbieden. Copyright 2010, Rabobank, versie 1.1, Mei 2012, 4

5 2 Aanmeldproces Het aanmelden voor ideal verloopt via het Rabo ideal Dashboard. In het onderstaande procesmodel staan de aanmeldstappen met de bijbehorende toelichting. ideal Servicedesk Acceptant 1 Registratie adres / wachtwoord 2 verificatie 4 Verifieren gegevens 3 Aanmelden 5 Contract opstellen 6 Contract ondertekenen 8 Contract opvoeren 7 Integreren in testomgeving 9 Test transacties 10 ideal activeren Figuur 1: Stappen in het aanmeld proces voor ideal Copyright 2010, Rabobank, versie 1.1, Mei 2012, 5

6 Stap Omschrijving Toelichting 1 Registratie adres / wachtwoord U registreert adres en wachtwoord op het Rabo ideal Dashboard ( Gelieve het opgegeven adres goed te onthouden opdat u dan via de link wachtwoord vergeten altijd een nieuw wachtwoord kunt opvragen. 2 verificatie Als controle op het ingevoerde -adres ontvangt u een e- mail met daarin een bevestigings-link voor het Rabo ideal Dashboard 3 Aanmelden Door voor de eerste keer in te loggen op het Rabo ideal Dashboard, kunt u de aanmelding voor ideal afmaken. Gevraagd wordt naar o.a. bedrijfs- en contactgegevens (o.a. KVK nummer, naam, tel.nr. en adressen van de commerciële en technische contactpersoon) en aansluitwijze op ideal. 4 Verifiëren gegevens De Rabobank ideal-desk controleert samen met uw lokale Rabobank de aanmelding. 5 Contract opstellen Uw lokale Rabobank verzorgt het ideal-contract en (als u heeft gekozen voor aansluiting op ideal via Rabo ideal Kassa of Rabo Internetkassa) ook een Rabo Internetkassa contract. 6 Contract ondertekenen Als uw aanmelding in orde is, verzoekt uw Rabobank u om ondertekening van een ideal-contract. Uw lokale Rabobank laat aan Rabobank Nederland weten dat het ideal contract door u ondertekend is. N.B. Stap 6 en 7 kunnen tegelijkertijd worden uitgevoerd 7 Integreren U kunt na verficatie direct starten met de integratie van ideal in de webwinkel. Hierbij dient u uw ideal aansluitnummer dat u bovenaan uw aanmeldingsgegevens/ kunt vinden (begint met 0020 ) opnemen in uw webwinkelomgeving. Het testen van de Integratie vindt plaats op de ideal testomgeving ( Deze integratiefase wordt succesvol afgerond met het uitvoeren van 7 verplichte testtransacties. Let op. Met de introductie van ideal release wordt deze URL aangepast in 8 Contract opvoeren De Rabobank ideal-desk laat in het Rabo ideal Dashboard vastleggen dat er een ideal contract met u is afgesloten. 9 Testtransacties Als de 7 verplichte testtransacties zijn uitgevoerd wordt dit automatisch vastgelegd in het systeem. 10 Activeren U ontvangt na afronding van de noodzakelijke stappen 8 en 9 binnen enkele uren een waarin uitgelegd wordt hoe ideal geactiveerd kan worden. Hierna kunt u ideal aanbieden aan uw klanten. Tabel 1: Stappen in het aanmeldproces voor ideal Copyright 2010, Rabobank, versie 1.1, Mei 2012, 6

7 2.1Aanmelden via het Rabo ideal Dashboard Het starten van de aanmelding voor ideal kan via de link bovenin het inlogscherm van het Rabo ideal Dashboard op Nadat een account aangemaakt is via het Rabo ideal Dashboard kunt u zich aanmelden voor ideal. Dit kan met via de menu-optie Aanmelden en tabblad Aanmelding Door bij URLinked uw website in te vullen, kunnen kopers die bij de Rabobank bankieren vanuit de betaalhistorie van Rabo Internetbankieren direct doorklikken naar de door u opgegeven homepage Inloggen op de TEST omgeving Er is door de RABO bewust gekozen voor een scheiding van productie- en testomgevingen. Inloggen in de testomgeving ( kan met dezelfde account gegevens als van de productieomgeving. Na inloggen ziet de omgeving er vergelijkbaar uit als de productieomgeving, met als verschil dat binnen deze omgeving het niet mogelijk om vragen in te sturen via een ticket. Vragen kunt u insturen via de menukeuze Tickets aan de productiekant van het Rabo ideal Dashboard ( Testcertificaat uploaden Wanneer u testtransacties naar de ideal testomgeving stuurt, moeten deze voorzien zijn van een elektronische handtekening die berekend is met het geheime deel van uw certificaat (voor aanmaak zie par. 8.4 in de Merchant Integratie Gids). Het niet geheime deel van het certificaat (public key) moet, om deze handtekeningen te controleren ingeladen worden door in te loggen op Via menukeuze Profiel het tabblad 'Certificaat/sleutel instellen' kan dit certificaat worden ingeladen. Kies het certificaatbestand en kies voor start upload. Denk er aan dat het certificaatbestand de extentie.cer moet hebben. Na succesvol uploaden verschijnt er een groen vinkje achter 'Certificaat upload'. N.B.: Om in productie te gaan moet deze stap opnieuw worden uitgevoerd aan de Copyright 2010, Rabobank, versie 1.1, Mei 2012, 7

8 productiekant van het ideal Dashboard ( voor het inladen van een productiecertificaat. Let er altijd op dat het gebruikte geheime certificaat in uw webwinkel hoort bij het opgevoerde publiek deel dat u uploadt in het ideal Dashboard Uitvoeren van testtransacties Zoals in stap 7 is aangegeven zijn er een aantal testtransacties die succesvol moeten worden afgerond alvorens ideal in productie te kunnen activeren. Deze transacties toetsen of uw implementatie voldoet aan de belangrijkste eisen. # Case naam 1 Success Door een transactie met een bedrag van 100 eurocent in te sturen wordt een status 'Success' teruggegeven. 2 Cancelled Door een transactie met een bedrag van 200 eurocent in te sturen wordt een status 'Cancelled' teruggegeven. 3 Expired Door een transactie met een bedrag van 300 eurocent in te sturen wordt een status 'Expired' teruggegeven. 4 Open Door een transactie met een bedrag van 400 eurocent in te sturen wordt een status 'Open' teruggegeven. Eindstatus is nog niet bekend. 5 Failure Door een transactie met een bedrag van 500 eurocent in te sturen wordt een status 'Failure' teruggegeven. 6 Directory Request Er moet een goed Directory Request worden ingestuurd. 7 Syntax error Door een transactie met een bedrag van 700 eurocent in te sturen wordt een foutbericht teruggegeven. In alle gevallen moet u ervoor zorgen dat de afhandeling van de teruggegeven berichten op een juiste wijze verloopt. Teksten die u kunt gebruiken in uw website bij een bepaalde status zijn: Tekst bij status Success: Uw betaling met ideal is geslaagd. / Your payment with ideal has been successful. Tekst bij status Cancelled U heeft de betaling met ideal afgebroken. / You have cancelled your payment with ideal. Tekst bij het niet kunnen insturen van een betaling Betalen met ideal is nu niet mogelijk. Probeer het later opnieuw of betaal op een andere manier. / You can not pay with ideal at this moment. Try it again later or choose another payment method. Tekst bij het terugontvangen van een open status. We hebben van uw bank nog geen bevestiging ontvangen. Als u in uw Internetbankieren ziet dat uw betaling heeft plaatsgevonden, zullen wij na ontvangst van de betaling tot levering overgaan. / We didn t receive a confirmation from your bank. When you see that your payment has been completed, we will deliver your order after we have received the payment. Copyright 2010, Rabobank, versie 1.1, Mei 2012, 8

9 Op het tabblad status kunt u de status van de testtransacties raadplegen. Nadat alle testtransacties succesvol afgerond zijn is de integratie geslaagd. Figuur 2: Statusoverzicht: Integratie Productiecertificaat uploaden Live Om ideal in productie te kunnen gebruiken, moet u ook in de productie-omgeving een certificaat uploaden. De sleutel gebruikt u in uw webwinkel en het bijbehorende certificaat moet u uploaden in het Rabo ideal Dashboard. Daarna kunt u uw aansluiting op ideal activeren. Om ideal daadwerkelijk te kunnen gebruiken is het nog van belang om de ideal berichten naar de juiste productie URL te sturen ( Let op. Met de introductie van ideal release wordt deze URL aangepast in Vanaf begin augustus 2012 kunt u de overstap maken naar versie Wij adviseren u vervolgens om de controles uit te voeren (zie controles 3.5). Copyright 2010, Rabobank, versie 1.1, Mei 2012, 9

10 2.2Beveiliging In verband met de beveiliging van bestelgegevens in uw webwinkel adviseren wij om een SSL certificaat te gebruiken. Strikt genomen is dit echter geen vereiste voor de communicatie tussen Consument en Acceptant Certificaten en fingerprint Het zipbestand met daarin dit document en de ideal Merchant Integratie Gids bevat ook een ideal.cer bestand. Dit bestand dient u voor zowel de test- als productieomgeving van ideal toe te voegen aan het certificaat (public key) waarmee u berichten kunt ontsleutelen Genereren van RSA sleutels Voor informatie over het maken van een sleutelpaar kunt u de Merchant Integratie Gids paragraaf 8.4 raadplegen Het certificaat kunt u uploaden in het Rabo ideal Dashboard, via het tabblad Certificaat/sleutel instellen URL Alle ideal berichten moeten naar worden gestuurd. Er wordt hierbij geen onderscheid gemaakt tussen het Directory-, Transaction- of Status-protocol. Testberichten moeten u insturen naar LET OP: Met de introductie van ideal release worden deze URL s aangepast in en Vanaf begin augustus 2012 kunt u de overstap maken naar versie Copyright 2010, Rabobank, versie 1.1, Mei 2012, 10

11 3 Verplichtingen Rabo ideal Professional 3.1 Ontvangen betalingen voor derden Om ideal betalingen voor derden te mogen ontvangen op uw eigen bankrekening dient u eerst een certificeringsproces te doorlopen bij Currence, de eigenaar van de ideal betaalmethode. Meer informatie hierover kunt u vinden op 3.2Gebruik merchant ID en SUB- ID s Elke acceptant heeft binnen ideal een uniek aansluitnummer (merchant ID). Alle aansluitnummers bij Rabobank beginnen met U kunt dit nummer in het Rabo ideal Dashboard bij de aanmeldinggegevens én in de aanmeldings terug vinden. Dit 9 cijferige nummer heeft u nodig om ideal te kunnen gebruiken Bij elke betaling van ideal wordt ook altijd een SUB-ID meegestuurd. De standaardwaarde hiervan is 0. Wie betalingen vanaf meerdere websites (met verschillende handelsnamen) op eenzelfde bankrekening wil ontvangen, dient gebruik te maken van SUB-ID s. Hierdoor krijgt de koper de juiste (voor de koper ook herkenbare) handelsnaam van de webwinkel te zien. Dat voorkomt dat kopers ideal transacties annuleren. Op het rekeningafschrift verschijnt dan achter uw bedrijfsnaam de voor de koper herkenbare handelsnaam. Standaard is de mogelijkheid om SUB-ID s te gebruiken niet geactiveerd. U kunt om activering van deze optie vragen door een ticket in te sturen. 3.3Leverplicht Elke Acceptant is verplicht om het bestelde product te leveren en te melden binnen welke termijn de levering plaats zal vinden. Voor on-line levering geldt dat na levering de content voor een periode van ten minste 7 dagen voor de consument online beschikbaar moet blijven. Voor tijdgebonden aanbiedingen zoals bijvoorbeeld concertkaartjes, is de Acceptant verplicht de betaal- en reserveringsstatus aan de consument te melden. 3.4Geldigheidsduur betaling Geadviseerd wordt om de geldigheidsduur op een waarde in te stellen tussen 1800 seconden (30 minuten) en 180 sec (3 minuten). Acceptanten die werken met reserveringen (bijvoorbeeld bij ticketverkoop of vakantiereizen) adviseren wij om te kiezen voor een beperkte geldigheidsduur (bijvoorbeeld 5 minuten). In andere gevallen adviseren wij een geldigheidsduur van 15 minuten. Na het verstrijken van de geldigheidsduur kunt u de definitieve eindstatus ophalen. Copyright 2010, Rabobank, versie 1.1, Mei 2012, 11

12 3.5Betaalstatus navraagplicht De Acceptant is altijd verplicht om, na het verstrijken van de geldigheidsduur, de eindstatus (success, failed, expired, cancelled) van de transactie op te vragen. Een geschikt schema voor het navragen is; - bij terugkeer van de consument op uw website; - na verstrijken van een percentage van de geldigheidsduur; en/of - nadat de geldigheidsduur is verstreken. Mocht u de eindstatus niet ontvangen nadat de geldigheidsduur verstreken is, adviseren wij u om het met ruimere tussenpozen van minimaal 1 uur opnieuw te proberen. 3.6Controleer uw aansluiting op ideal 1. Controleer of in de keuzelijst van ideal banken correct geïmplementeerd is (Bovenaan de shortlist en onderaan de longlist. Beide lijsten in alfabetische volgorde): Zie voor een voorbeeld de Merchant Integratie Gids paragraaf Nadat de klant kiest om met ideal te betalen moet direct de lijst met ideal banken aangeboden worden. De klant mag dan niet meer met extra handelingen geconfronteerd worden die de klant af kunnen leiden van het ideal betaalproces. Copyright 2010, Rabobank, versie 1.1, Mei 2012, 12

13 4 Eisen aan de huisstijl De Acceptant is, bij het gebruik van de ideal betaalmethode in zijn winkel, verplicht de eisen die volgen uit de huisstijl van ideal te volgen. Informatie over de huisstijl van ideal is te vinden op: 4.1Merk Producten die gebaseerd zijn op de ideal standaarden zijn te herkennen aan het ideal beeldmerk. Afb. 2: ideal beeldmerk Betaalmethode, bankselectie en betaalknop De Acceptant is primair verantwoordelijk voor het initiëren van de betaling en de communicatie naar de consument betreffende de status van de bestelling. Betaalmethode Een Acceptant die ideal als betaalmethode accepteert, dient de ideal betaalmethode op te nemen in zijn lijst met alle aangeboden betaalmethoden, op die plaats in zijn orderproces waar dit gebruikelijk is. De ideal betaalmethode dient op een dusdanige manier in de lijst met aangeboden betaalmethoden te worden opgenomen, dat zij minimaal gelijke aandacht krijgt als andere betaalmethoden. Betaalknop Het moet voor de consument duidelijk herkenbaar zijn hoe en wanneer de ideal transactie wordt gestart. Dit kan door een zogenaamde betaalknop aan te bieden op de pagina waar de bestelling wordt samengevat. De ideal betaalknop met daarop het ideal beeldmerk, moet worden ingedrukt om de transactie te starten. De toegestane afbeeldingen voor de ideal betaalknop worden beschikbaar gesteld op Copyright 2010, Rabobank, versie 1.1, Mei 2012, 13