Extensie voor Magento

Extensie voor Magento

Inhoudsopgave 1. Disclaimer 2. Installatie in Magento 2.1 Voorwaarden 2.2 Installatie in Magento 1.7 en hoger 2.3 Installatie Magento 2.x 3. Configuratie 3.1 Ingenico epayments-backoffice 3.1.1 Betaalmethoden 3.1.2 Gebruikersbeheer 3.1.3 Technische informatie 3.2 Magento 3.2.1 Betalingsdiensten 3.2.2 Betaalmethoden 3.2.3 Open-invoice-betaalmethode 3.2.4 InterSolve-betaalmethode 3.2.5 Creditcardbetaalmethode met Alias manager 3.2.6 Paypal-betaalmethode met verkopersbescherming 3.2.7 Device fingerprinting 4. Gebruik 4.1 Algemeen 4.1.1 InterSolve-betaalmethode 4.1.2 Creditcardbetaalmethode met Alias manager 4.1.3 Domiciliëring / automatische incasso betaalmethode 4.2 Verzendbon Page 1 of 22-28/03/2019

4.3 Annuleringen 4.4 Facturatie 4.5 Terugbetalingen en creditnota 4.6 Bijkomende informatie 4.7 Betalingen in Magento activeren 4.7.1 Betaling met behulp van bestaande Ingenico epayments-transactie 5. Toelichtingen 5.1 Algemeen 5.2 Multistore 5.2.1 Voorbeeld: winkelcode in URL door gebruik te maken van dezelfde Ingenico epayments-account 5.2.2 Voorbeeld: verschillende domeinen en verschillende Ingenico epayments-accounts 5.2.3 Voorbeeld: verschillende domeinen door gebruik te maken van dezelfde Ingenico epayments-account 5.2.4 Voorbeeld: winkelcode in URL door gebruik te maken van dezelfde Ingenico epayments-account 6. Betalingsworkflow 7. Ingenico epayments/magento status mapping 8. Veelgestelde vragen Page 2 of 22-28/03/2019

1. Disclaimer **EEN UPDATE VERSIE VAN DE GIDS ZAL BINNEN ZEVEN SEPTEMBER BINNENKORT BESCHIKBAAR ZIJN** Copyright 2016 Ingenico epayments. Alle in deze teksten genoemde handelsmerken, servicemerken en handelsnamen zijn eigendom van de respectieve eigenaren. De hierin opgenomen informatie is verstrekt als service en is uitsluitend bedoeld ter informatie. Deze informatie is niet bedoeld als een volledige beschrijving van alle toepasselijke regels, beleidslijnen en procedures. De genoemde onderwerpen kunnen van tijd tot tijd veranderen, en individuele omstandigheden kunnen verschillen. Ingenico epayments kan niet aansprakelijk worden gesteld voor eventuele onjuiste of onvolledige informatie. De informatie in dit document bevat, onder andere, een compilatie van de ontvangen informatie van derden en deze informatie is en blijft eigendom van zijn respectieve eigenaar. Niets in deze voorstelling is bedoeld als aanvulling of wijziging van enig toepasselijk contract, regel of regelgeving. Ingenico epayments heeft veel aandacht besteed aan de inhoud van deze informatie, maar geeft geen verklaringen of garanties over de juistheid of volledigheid ervan. Noch Ingenico epayments noch zijn gelieerde bedrijven zijn aansprakelijk voor eventuele kosten, verliezen en/of schade voortvloeiend uit toegang tot of gebruikmaking van de inhoud van dit document. Vanwege de complexiteit van het proces en het recht van banken om voorwaarden te wijzigen, kan dit document uitsluitend dienstdoen als een beschrijving, waarbij verdere wijzigingen zijn voorbehouden. De in dit document genoemde extensie is ontwikkeld als een generieke oplossing. Ingenico epayments kan niet aansprakelijk worden gesteld voor eventuele schade als gevolg van de extensie. Indien de extensie door een gebruiker op enigerlei wijze wordt gewijzigd, kan Ingenico epayments niet aansprakelijk worden gesteld voor eventuele schade als gevolg van de gewijzigde extensie. De beschrijving van de extensie in dit document is slechts verstrekt als service, en Ingenico epayments geeft geen verklaringen of garanties over het gebruik of de werking van de extensie. Noch Ingenico epayments noch zijn gelieerde bedrijven zijn aansprakelijk voor eventuele kosten, verliezen en/of schade voortvloeiend uit toegang tot of gebruikmaking van de extensie. Page 3 of 22-28/03/2019

2. Installatie in Magento 2.1 Voorwaarden PHP 5.4+ Een actieve Ingenico epayments-account De ondersteunde Magento Community- en Enterprise Edition-versies vindt u op de "Official Ingenico epayments Extension"-pagina. 2.2 Installatie in Magento 1.7 en hoger 1. 2. 3. 4. Ga naar de sectie Magento Connect van de Magento Commerce-website. Meld u aan met uw Magento Connect-account of maak er één aan. Zoek de "Official Ingenico epayments Extension", of navigeer naar https://www.magentocommerce.com/magento-connect/officialingenico-epayments-extension-1.html Klik op de knop "Install" en kopieer de installatiesleutel. 5. 6. Meld u aan op uw Magento -backoffice. Ga naar "System > Magento Connect > Magento Connect Manager". Meld u aan op uw "Magento Connect Manager". Kies het tabblad "Extensions". Plak de installatiesleutel van de uitbreiding in het juiste veld in de sectie "Install New Extensions" en klik op de knop "Install" (in sommige gevallen moet u op "Proceed" klikken om de installatie te bevestigen). De installatie wordt voortgezet en na een tijdje wordt in het consolevenster de melding "Package... installed successfully" weergegeven. De uitbreiding is nu correct geïnstalleerd en aan de lijst met geïnstalleerde pakketten toegevoegd onder "Manage Existing Extensions" in de "Magento Connect Manager". 2.3 Installatie Magento 2.x Neem contact op met ons Customer Care-team voor meer informatie over onze Magento 2.x-extensie. Page 4 of 22-28/03/2019

3. Configuratie 3.1 Ingenico epayments-backoffice Meld u aan op uw Ingenico epayments-backoffice om de volgende instellingen in te voeren. 3.1.1 Betaalmethoden Naargelang het Ingenico epayments-abonnement dat u hebt gekozen, kan het nodig zijn om aanvullende verplichte opties in uw Ingenico epayments-account te activeren. Deze opties zijn: OPC DirectLink (New Payment) DirectLink (Maintenance) D3D Alias Manager (ga naar Credit card with Alias Manager voor meer informatie). Controleer of deze opties standaard zijn geactiveerd. Indien dit niet het geval is, neem dan contact op met ons Sales team voor activering. De Magento Ingenico epayments extension aangeboden door Ingenico epayments werkt mogelijk niet in combinatie met andere uitbreidingen. Om storingen te voorkomen raden we u aan om alle andere extra uitbreidingen in Magento uit te schakelen. 3.1.2 Gebruikersbeheer De winkel heeft een aparte API-gebruiker nodig om te communiceren met Ingenico epayments. Maak de API-gebruiker aan: 1. 2. 3. 4. 5. 6. 7. Ga naar "Configuration > Users". Kies "New User". Kies een USERID (bijvoorbeeld APIUSER). Vul de naam en een bestaand e-mailadres in (het veld "External USERID" kan leeg worden gelaten). Kies het profiel "Administrator". Kies het toegangstype "API only". Noteer de USERID en het wachtwoord die u hebt aangemaakt. Opmerking: de USERID en het wachtwoord mogen geen speciale tekens bevatten. 3.1.3 Technische informatie Configureer de technische informatie in de Ingenico epayments-backoffice: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. Ga naar "Configuration > Technical Information > Global Transactionparameters". Kies "Sale" of "Authorisation" in de sectie "Default operation code". Als u dat wenst, kunt u in de sectie "Payment retry" de waarde wijzigen. Klik op de knop "Opslaan". Selecteer het tabblad "Global security parameters". In de sectie "Hashing method" kiest u "SHA-1" voor "Hash algorithm" en "UTF-8" voor "Character encoding". In de sectie "Template" kiest u "No" voor "Enable JavaScript check on template". Klik op de knop "Opslaan". Selecteer het tabblad "Data and origin verification". Vul in beide secties "Checks for e-commerce & Alias Gateway" en "Checks for Ingenico epayments DirectLink and Ingenico epayments Batch (Automatic)" de "SHA-IN pass phrase" in. Beide sleutels moeten uitsluitend alfanumeriek zijn en dezelfde waarde hebben. Page 5 of 22-28/03/2019

11. Selecteer het tabblad "Transaction feedback". 12. Selecteer "I would like to receive transaction feedback parameters on the redirection URLs" in de subsectie "HTTP redirection in the browser" van de sectie "e-commerce", en deselecteer "I would like Ingenico epayments to display a short text to the customer on the secure payment page if a redirection to my website is detected...". 13. In de subsectie "Direct HTTP server-to-server request" van de sectie "e-commerce"... 1. Selecteer "Online but switch to a deferred request when the online requests fail" 2. Vul in beide velden voor "URL of the merchant's post-payment page" de waarde "YOUR_SHOP_URL/ops/api/postBack" in. 3. Kies "POST" als "Request method". 14. 15. 16. 17. 18. 19. Selecteer in de subsectie "Dynamic e-commerce parameters" van de sectie "e-commerce" alle beschikbare parameters behalve "ECOM_BILLTO" en "ECOM_SHIPTO", omdat deze gemakkelijk kunnen leiden tot overdrachtsfouten. Vul in de sectie "All transaction submission modes" de "SHA-OUT pass phrase" in. De SHA-OUT-wachtzin moet identiek zijn aan de eerder ingevoerde SHA-IN-wachtzin. Selecteer "For each offline status change (payment, cancellation, etc.)." in de sectie "HTTP request for status changes" en vul de waarde "YOUR_SHOP_URL/ops/api/directLinkPostBack" in. Klik op de knop "Opslaan". Selecteer het tabblad "Transaction e-mails". Voer in de sectie "E-mails to the merchant" de volgende optionele handelingen uit... 1. Vul uw e-mailadres in. 2. Selecteer "Yes, for all transaction submission modes." 3. Selecteer "Yes, for each offline status change (payment, cancellation, etc.)." 20. 21. Selecteer het tabblad "Test info". Selecteer "I would like to simulate transaction results based on the card number." in de sectie "Test info". 3.2 Magento 3.2.1 Betalingsdiensten Voer na de installatie van de uitbreiding de volgende stappen uit: 1. 2. 3. Meld u aan op uw Magento -backoffice. Ga naar "System > Configuration > Sales > Payment services". De optie "Ingenico epayments Account" zal beschikbaar zijn. Selecteer de optie en vul de volgende informatie in: Instelling Omschrijving PSPID Vul het PSPID van uw Ingenico epayments-account in. SHA-IN Pass phrase Vul de SHA-IN-wachtzin in die u hebt ingesteld in uw Ingenico epayments-backoffice onder "Technical information > Data and origin verification". SHA-OUT Pass phrase Vul de SHA-OUT-wachtzin in die u hebt ingesteld in uw Ingenico epayments-backoffice onder "Technical information > Transaction feedback". Gateway URLs De gateway-url's zijn al correct geconfigureerd. Wanneer u echter overschakelt van de testomgeving naar de productieomgeving, moet u deze TEST-URL's vervangen door PRODUCTIE-URL's die in de commentaar van dit configuratieveld worden getoond. API User / API Password Vul de API-gegevens in die u in uw Ingenico epayments-backoffice hebt aangemaakt. Page 6 of 22-28/03/2019

Betaalsjabloon Wanneer u de Magento - Internal-winkelsjabloon kiest, wordt de betaalpagina in dezelfde lay-out weergegeven als uw winkel. Wanneer u een van de Ingenico epayments-opties selecteert, moeten alle daaropvolgende velden met verwijzing naar de Ogone-sjabloon verplicht worden ingevuld. -Ingenico epayments - Dynamisch sjabloon: De klant wordt doorgestuurd naar de Ingenico epaymentsbetaalpagina. Het uitzicht van die pagina wordt gedefinieerd door een dynamisch geladen sjabloonbestand, dat kan worden gedefinieerd met de "Template Identifier/URL" direct erna. -Ingenico epayments - iframe-modus: De klant moet de betaalgegevens invoeren op een pagina in uw winkel die de Ingenico epayments-betaalpagina in een iframe host. U kunt de stijlparameters direct erna configureren. -Ingenico epayments - Redirect-modus: De klant wordt doorgestuurd naar Ingenico epayments om zijn betaalgegevens in te voeren. U kunt de stijlparameters direct erna configureren. -Magento - Internal-winkelsjabloon: De klant wordt doorgestuurd naar de Ingenico epaymentsbetaalpagina met het uitzicht van uw winkel. De URL van de gebruikte sjabloon wordt direct erna weergegeven. Order reference in case of redirect (or inline) payments Met deze optie kan worden opgegeven of het Orders increment ID of het Quote ID moet worden getransfereerd als betalingsreferentie voor de bestellingen bij Ingenico epayments. Het Order ID is het nummer in het formaat 100000001 dat is opgenomen in het backend-besteloverzicht in kolom "Order #". In het geval dat het "Order ID" wordt geselecteerd, wordt dit nummer tijdens het betaalproces naar Ingenico epayments getransfereerd. Om compatibiliteitsredenen wordt voor het Order (increment) ID een hekje toegevoegd. Als "Quote ID" wordt geselecteerd, dan zal dit nummer naar Ingenico epayments worden getransfereerd. Het Quote ID is ook de enige modus voor alle inline-betaalmethodes zoals creditcard (indien geactiveerd), automatische incasso en Kwixo. Show Quote ID in the order grid Indien geactiveerd, wordt het Quote ID toegevoegd als een kolom in het backend-besteloverzicht. Submit extra parameters Indien geactiveerd, worden extra parameters naar Ingenico epayments verzonden om gebruik te maken van fraudedetectie of de verkopersbescherming van Paypal. Device ID Activeert het traceren van de klant voor fraudedetectiedoeleinden Identiteit/sjabloon met betaalinformatie opnieuw verzenden U kunt een e-mail naar uw klanten sturen als hun betaling bij Ogone mislukt is (status 0 of 2). De mail bevat een koppeling naar de Ogone-betaalpagina, waar de klant zijn betaalgegevens opnieuw kan invoeren om de bestelling te recupereren. fresend payment information Identity: Selecteer het contact door wie de e-mail moet worden verzonden (gekoppeld aan "Store Email Addresses") fresend payment information Template: Selecteer het e-mailsjabloon van uw keuze Debug Wanneer deze optie wordt geselecteerd, worden alle verzoeken en antwoorden van Ingenico epayments gecontroleerd. We raden u aan om deze optie alleen te activeren wanneer u in testmodus en niet in productiemodus werkt. Het debug-bestand is opgeslagen op de fileserver in /Var/Logs/ops.log Opmerking: In "System > Configuration > General > Web > URL options" raden we u aan om de optie "Add store code to URL's" uit te schakelen, omdat de uitbreiding zich hierdoor verkeerd zou kunnen gedragen. 3.2.2 Betaalmethoden Configureer uw betaalmethoden in "System > Configuration > Payment Methods". Page 7 of 22-28/03/2019

Activeer alleen betaalmethoden die in uw Ingenico epayments-backoffice zijn geactiveerd via "Configuration > Payment methods > Selected payment methods". U kunt de betaaltypes van de relevante landen configureren. Voorbeeld: wanneer Nederland geselecteerd is als het facturatieland voor ideal, verschijnt dit niet wanneer de klant een ander facturatieland ingeeft. Voor activeringen en verdere wijzigingen kunt u contact opnemen met ons Customer Care team via admin.ecom@ingenico.com. 3.2.3 Open-invoice-betaalmethode Activeer de volgende bijkomende instellingen in "System > Configuration > Customer Configuration > Name and address options": Display Birthday Display VAT number (alleen van toepassing voor Open Invoice NL) Display Gender Opmerking: Als u als acquirer via ons Afterpay gebruikt, dan is het niet mogelijk om gedeeltelijke registraties uit te voeren met Open Invoice NL. Wanneer u Open Invoice AT via Klarna activeert, zijn de volgende voorwaarden van toepassing: 1. 2. 3. 4. 5. 6. De "Title" moet ingesteld zijn op "Kauf auf Rechnung - zahlen in 14 Tagen". Het logo moet worden geüpload en beschikbaar worden gesteld op https://developers.klarna.com/en/at+php/kpm/logos. De gegevenscodering moet worden ingesteld op "other" omdat de huidige integratie geen UTF-8-codering ondersteunt. De "Invoice terms title" moet worden ingesteld op "Rechnungsbedingungen". De "Invoice terms url" moet worden ingesteld op https://cdn.klarna.com/1.0/shared/content/legal/terms/123/de_at/invoice?fee=0# Een gedeeltelijke registratie of gedeeltelijke terugbetaling via Magento is niet mogelijk. Deze acties kunnen alleen worden uitgevoerd via het Ingenico epayments Back-Office. 7. Magento moet geen factuur over registratie/terugbetaling naar de consumenten verzenden, Klarna verzendt de factuur. Tijdens de registratie/terugbetaling moet de instelling "Email Copy of Invoice" gedeselecteerd zijn. Page 8 of 22-28/03/2019

3.2.4 InterSolve-betaalmethode U kunt verschillende merken toevoegen die overeenkomen met specifieke Ingenico epayments-betaalmethoden. Deze merken moeten op voorhand in de Ingenico epayments-backoffice worden geconfigureerd voordat u ze in uw winkel kunt gebruiken. U kunt ieder "Brand" een aangepaste "Title" geven die aan de klant op de betaalpagina wordt getoond. Page 9 of 22-28/03/2019

3.2.5 Creditcardbetaalmethode met Alias manager De Alias Manager verwijst naar de Ingenico epayments Alias Manager. Configuratie: Instelling Omschrijving Enabled Alias Manager Indien geactiveerd, heeft uw klant de mogelijkheid om zijn creditcardgegevens op te slaan en de opgeslagen informatie voor andere betalingen in de toekomst opnieuw te gebruiken. Deze informatie kan alleen worden opgeslagen voor kaarten waarmee online kan worden betaald. Show Alias Manager information for guests Indien geactiveerd, wordt uw klant met een melding geïnformeerd over de voordelen van opgeslagen creditcardgegevens. Deze optie is echter alleen beschikbaar voor klanten die zijn aangemeld. Voor een correct gebruik van deze functie moet u het cron.php-bestand in de rootdirectory van Magento periodiek uitvoeren. Op een Unix- of Linux-achtig systeem moet u een van de volgende vermeldingen aan uw crontab toevoegen: */5 * * * * /bin/sh /absolute/path/to/magento/cron.sh 0,5,10,15,20,25,30,35,40,45,50,55 * * * * /bin/sh /absolute/path/to/magento/cron.sh Ga naar Credit card with Alias Manager voor meer informatie over het gebruik. 3.2.6 Paypal-betaalmethode met verkopersbescherming Configureer de volgende instellingen: Instelling Omschrijving Configuration > General > State options > State is required for Selecteer de landen waarvoor de staat verplicht is volgens de eisen van de verkopersbescherming van Paypal. Configuration > Payment Services > Ingenico epayments account > Submit extra parameters Stel in op 'Yes' om de nodige parameters naar Ingenico epayments te verzenden. 3.2.7 Device fingerprinting Met deze functie is uitbreiding mogelijk tot klantapparaten met vingerafdrukfunctie voor Ingenico epayments om gegevens in te zamelen en te hashen (zoals schermresolutie, user agent, enz.) tot een sleutel. In sommige Europese landen zijn juridische waarschuwingen van toepassing, zodat de klant zijn toestemming moet geven voor het inzamelen van deze gegevens. De vingerafdrukfunctie van het apparaat kan per transactie worden geactiveerd/gedeactiveerd. Dit wordt aangegeven met een speciale parameter voor e-commerce-transacties. Voor DirectLink-transacties moet informatie worden ingezameld door pixels ter plaatse te tracken. Integratie via JavaScript Hook De extensie biedt een JavaScript-functie om de toestemming van de klant bij de afrekening te verwerken. Klanten kunnen ook het bestand (js/netresearch/ops/devicefingerprinting.js) toevoegen aan andere delen van de winkel om toegang te hebben tot de Page 10 of 22-28/03/2019

hierna beschreven functies. Dit is mogelijk met de volgende code: consenthandler.toggleconsent( consent, callback ); Consent: Booleaans en de doelstatus van de toestemming die moeten worden opgeslagen in de klantsessie. Callback: Een optionele functie die moet worden opgeroepen met de opgeslagen toestemming nadat deze werd opgeslagen. De toestemmingshandler heeft ook een functie om de huidige toestemmingsstatus op te vragen via consenthandler.getconsent (callback) Zoals met de andere functie wordt de callback opgeroepen met het resultaat van de aanvraag (de huidige status van de toestemming). Integratie via custom call naar voorziene controller Toestemming kan ook worden aangegeven door een controller direct op de volgende url op te roepen: http://www.yourshop.tld/ops/device/toggleconsent De parameter "consent" wordt verwacht voor de aanvraag. Deze wordt naar Booleaans gestuurd en opgeslagen in de sessie van de klant. Als reactie van de huidige toestemmingsstatus als JSON krijgen we bijvoorbeeld: {"consent":false} Een huidige toestemmingsstatus kan hier worden bekeken: http://www.yourshop.tld/ops/device/consent De voorgebouwde JavaScript-functies roepen deze url's op. Page 11 of 22-28/03/2019

4. Gebruik 4.1 Algemeen De extensie werkt zoals de meeste Magento -extensies. Als u hebt gekozen om creditcards te verwerken, dan zullen deze via het Magento -platform worden verwerkt. Wanneer 3-D Secure is geactiveerd, wordt de kaarthouder echter naar de Ingenico epayments-betaalpagina omgeleid. Dit geldt ook voor alle andere betaalmethoden waarbij de gegevens van de rekeninghouder door de uitgever moeten worden bevestigd. Wanneer de transactie is verwerkt, kunt u deze in uw Magento -back-office bekijken via "Sales > Orders". 4.1.1 InterSolve-betaalmethode Bij het configureren in Magento kunt u verschillende merken definiëren die tijdens het afrekenen door de klant kunnen worden gekozen. Het gekozen merk zal naar Ingenico epayments worden verzonden. Als er slechts één merk is gedefinieerd, dan kan de klant geen merk kiezen. In dat geval wordt het merk direct weergegeven en onmiddellijk naar Ingenico epayments verzonden. 4.1.2 Creditcardbetaalmethode met Alias manager Bij gebruik van de betaalmethode "credit card" en de geactiveerde functie Alias Manager krijgt een aangemelde klant zijn opgeslagen creditcardgegevens te zien als hij deze vooraf heeft opgeslagen. Als de klant niet is aangemeld, verschijnt er een boodschap waarin de klant wordt geïnformeerd over de mogelijkheid om zijn creditcardgegevens op te slaan voor later gebruik. Als de klant op de link in de boodschap klikt, dan wordt hij naar de "checkout method"-stap geleid en wordt de "register"-optie geselecteerd. De selectie van de weergegeven betalingsgegevens is afhankelijk van factuur- en verzendadres om misbruik te voorkomen. Als uw klant zijn betalingsgegevens wil opslaan, dan moet hij die optie op het creditcardbetalingsscherm aanvinken. Als opgeslagen creditcardgegevens beschikbaar zijn, dan zal het formulier op het creditcardbetalingsscherm vooraf zijn gevuld en zullen de invoervelden grijs worden weergegeven. Als de klant zijn opgeslagen creditcardgegevens wil bijwerken, dan moet hij: 1. 2. 3. in een van de grijze invoervelden klikken. Hierdoor zullen alle invoervelden worden gewist; de nieuwe creditcardgegevens invoeren; de optie "Save payment information" aanvinken. Als deze optie niet wordt aangevinkt, dan zullen de nieuwe betalingsgegevens voor de betaling worden gebruikt, maar niet worden opgeslagen. De oude betalingsgegevens blijven in dat geval beschikbaar voor verder gebruik. Als u de klant zijn betalingsgegevens wil bekijken en/of verwijderen, dan moet u: in de Ingenico epayments-backoffice naar "payment information" gaan en de betreffende opdracht uitvoeren. in Magento : 1. naar "customers > manage customers" gaan; 2. op de rij van de klant klikken; 3. "Payment information" kiezen; 4. de betreffende opdracht uitvoeren. 4.1.3 Domiciliëring / automatische incasso betaalmethode U kunt de betaalmethode automatische incasso gebruiken voor Oostenrijk, Duitsland en Nederland. Hiermee kan uw klant zijn Page 12 of 22-28/03/2019

rekeninggegevens gebruiken voor betalingen. Overzicht van de functies: Oorsprong van de automatische-incassobetaalmethode Duits Oostenrijks Nederlands Klant moet rekeningnummer invoeren (Kontonummer, rekeningnummer) X X X Klant moet bankcode invoeren (BLZ) X X Klant kan IBAN invoeren X X Klant kan BIC invoeren X X Opmerking: als de klant zowel IBAN als BIC invoert, samen met de overeenkomstige rekeninggegevens, dan worden IBAN en BIC gebruikt voor de verwerking van de betaling. U kunt de betaalmethode automatische incasso ook gebruiken voor zogenaamde MOTO-transacties in Magento. Dit betekent dat u Mail Order/Telephone Order-transacties aanvaardt en handmatig invoert. Het gedrag is hetzelfde zoals hierboven beschreven. 4.2 Verzendbon Het aanmaken van een verzendbon gebeurt zonder verbinding met de betaalservice en gedraagt zich daarom als Magento -Standard. 4.3 Annuleringen Indien de autorisatie met succes is voltooid, hebt u op het "order view"-scherm in Magento een "Void"-knop (in "Sales > Orders" en klik op uw bestelling). Het annuleren gebeurt met deze "Void"-knop in plaats van de "Cancel"-knop (vanwege de gateway-workflow). Als de annulering met succes door Ingenico epayments is verwerkt, kan het in sommige Magento -versies nodig zijn dat u op de "Cancel"-knop klikt om de juiste annuleringsstatus in Magento in te stellen. In het geval dat de bestelling de status "Pending Payment" heeft en de Ingenico epayments-status "0" of "empty" is, kunt u de bestelling annuleren met behulp van de knop "Annuleren": Er wordt geen gateway-verzoek naar Ingenico epayments verzonden. De voorraad wordt opnieuw verhoogd. Controleer vooraf de status van betaling in de Ingenico epayments-backoffice. Anders zult u de status niet meer kunnen bijwerken in Magento. 4.4 Facturatie Ongeacht of u "Authorization" als "Payment Action" hebt gekozen in de Magento -configuratie, voor creditcardbetaalmethoden moet u altijd een factuur aanmaken om het registratieproces door Ingenico epayments te activeren. Om een factuur aan te maken: 1. 2. 3. Ga naar het Magento "Order view" (in "Sales > Orders" en klik op de bestelling). Klik op de knop "Invoice". Kies "Capture Online" als bedrag. Page 13 of 22-28/03/2019

4. Klik op de knop "Submit Invoice". 4.5 Terugbetalingen en creditnota Om een terugbetaling aan te maken: 1. 2. 3. 4. 5. 6. 7. Ga naar Sales> Facturen. Klik op de factuur die moet worden terugbetaald. Klik op de "Credit Memo"-knop. Pas het terug te betalen bedrag aan. Selecteer de optie "Close Ingenico epayments transaction", indien gewenst. Klik op de "Refund"-knop om te bevestigen. Klik niet op de knop "Refund Offline"! Herhaal deze procedure totdat de Ingenico epayments-transactie is afgesloten. Dit betekent dat het volledige bedrag al is terugbetaald of dat u de optie "Close the Ingenico epayments transaction" hebt geselecteerd. In het laatste geval zijn alleen offlineterugbetalingen beschikbaar. Afhankelijk van de betaalmethode zal de terugbetaling onmiddellijk of na een korte verwerkingstijd door Ingenico epayments worden uitgevoerd. Met de "Credit Memo"-knop op de "Order view" creëert u alleen een interne terugbetaling en activeert u geen terugbetaling door Ingenico epayments. Voor sommige betaalmethoden (bv. ideal) moet u terugbetalingen activeren in uw Ingenico epayments-account. 4.6 Bijkomende informatie Voor extra betalinggerelateerde informatie over de bestelling: 1. 2. 3. Ga naar "Order view" in "Sales > Orders". Kies "Information". Raadpleeg de "Payment Information"-sectie. De informatie omvat: Type betaalmethode (bv. VISA-creditcard) Betaal-ID Recente betalingsstatus Munteenheid 4. Raadpleeg de sectie "Comments History". Dit deel bevat de geschiedenis van de betalingsstatuswijzigingen. Dankzij deze informatie kunt u controleren of een creditcardautorisatie is veranderd als gevolg van de registratie van een betaling. 4.7 Betalingen in Magento activeren In het kader van Ingenico epayments MOTO (Mail Order/Telephone Order) eterminal-transacties zijn bepaalde betaalmethoden beschikbaar voor het aanmaken van bestellingen in Magento. U kunt geen betaalmethoden met een omleiding gebruiken, omdat deze niet zijn toegestaan. Ook 3D Secure ("Verified by Visa", "MasterCard Secure Code") kunt u niet gebruiken. Om creditcard- en/of automatische-incassobetalingen voor MOTO eterminal-transacties mogelijk te maken moet u de optie "Enable voor backend" op "YES" instellen in "System > Configuration > Payment methods > Select credit card and/or direct debit payment method". Onmiddellijk nadat u de bestelling hebt ingevoerd, stuurt Magento al een aantal gegevens naar de winkel. U zou dus de indruk Page 14 of 22-28/03/2019

kunnen krijgen dat u twee keer op de knop "Order submit" moet klikken. U kunt via e-mail ook een koppeling doorsturen van de betaalpagina waar de betaling kan worden voltooid. Om deze functionaliteit te ondersteunen, dient u deze optie te activeren via System -> Configuration -> Payment Methods -> PayPerMail. 4.7.1 Betaling met behulp van bestaande Ingenico epayments-transactie Met deze betaalmethode, die alleen beschikbaar is in Magento en niet in uw winkel, kunt u direct het PAY-ID van een bestaande Ingenico epayments-transactie invoeren. In dat geval wordt er geen verzoek naar Ingenico epayments verzonden en moet u alle statuswijzigingen handmatig uitvoeren. Page 15 of 22-28/03/2019

5. Toelichtingen 5.1 Algemeen De volgende statussen kunnen in Magento worden weergegeven: No credits in Ingenico epayments back office: Dit betekent dat u uw kredietaanvragen alleen via Magento kunt verzenden. 3D-Secure (MasterCard, SecureCode and Verified by Visa) must be activated: Dit betekent dat uw Ingenico epayments-account 3D-Secure moet accepteren. 5.2 Multistore U kunt de uitbreiding in Magento Multistores gebruiken met: meerdere websites meerdere winkels meerdere domeinen meerdere Ingenico epayments-accounts Om meerdere Ingenico epayments-accounts te gebruiken moet u de stappen volgen die gedetailleerd zijn in de Ingenico epaymentsback-office en Magento voor iedere Ingenico epayments-account en website of winkel. Het belangrijkste is dat u de antwoord-urls in de Ingenico epayments-back-office juist instelt: 1. 2. Ga naar "Configuratie > Technische instellingen > Transactiefeedback". Configureer de volgende velden: Direct HTTP server-to-server request HTTP request for status changes De juiste configuratie van deze URL's wordt toegelicht met de volgende voorbeelden. 5.2.1 Voorbeeld: winkelcode in URL door gebruik te maken van dezelfde Ingenico epayments-account De Multistore bestaat uit twee winkels die aan dezelfde website zijn gekoppeld. Het voorbeeld is ook geldig wanneer beide winkels aan verschillende websites zijn gekoppeld: Winkel A opereert onder http://www.my-shop.com/shopa/ Winkel B opereert onder http://www.my-shop.com/shopb/ De juiste configuratie in de Ingenico epayments-backoffice is de volgende: Direct HTTP server-to-server request: http://www.my-shop.com/shopa/ops/api/postback HTTP request for status changes: http://www.my-shop.com/shopa/ops/api/directlinkpostback De feedback zal correct worden verwerkt voor winkel B, ook als het antwoord alleen naar de URL van winkel A wordt verstuurd. 5.2.2 Voorbeeld: verschillende domeinen en verschillende Ingenico epayments-accounts De MultiStore bestaat uit twee winkels die aan verschillende websites zijn gekoppeld en gebruikmaken van twee verschillende Ingenico epayments-accounts: Winkel A opereert onder http://www.my-shop-a.com/ Winkel B opereert onder http://www.my-shop-b.com/ De juiste configuratie voor winkel A in de Ingenico epayments-backoffice is de volgende: Direct HTTP server-to-server request: http://www.my-shop-a.com/ops/api/postback Page 16 of 22-28/03/2019

HTTP request for status changes: http://www.my-shop-a.com/ops/api/directlinkpostback De juiste configuratie voor winkel B in de Ingenico epayments-backoffice is de volgende: Direct HTTP server-to-server request: http://www.my-shop-b.com/ops/api/postback HTTP request for status changes: http://www.my-shop-b.com/ops/api/directlinkpostback 5.2.3 Voorbeeld: verschillende domeinen door gebruik te maken van dezelfde Ingenico epayments-account De MultiStore bestaat uit twee winkels die aan verschillende websites en hetzelfde Ingenico epayments-account zijn gekoppeld: Winkel A opereert onder http://www.my-shop-a.com/ Winkel B opereert onder http://www.my-shop-b.com/ De juiste configuratie voor beide winkels in de Ingenico epayments-backoffice is de volgende: Direct HTTP server-to-server request: http://www.my-shop-a.com/ops/api/postback HTTP request for status changes: http://www.my-shop-a.com/ops/api/directlinkpostback U moet ook Magento 's basis-url voor winkel B configureren: 1. 2. 3. Ga naar "System > Configuration > General > Web". Voer "http://www.my-shop-b.com/" in in de "Base URL" en de "Base Link URL"-velden in de sectie "Unsecure". Gebruik/behoud de standaardwaarde voor de andere velden van de sectie "Unsecure". Voer "https://www.my-shop-b.com/" in in de "Base URL" en de "Base Link URL"-velden in de sectie "Secure". Gebruik/behoud de standaardwaarde voor de andere velden van de sectie "Secure". 5.2.4 Voorbeeld: winkelcode in URL door gebruik te maken van dezelfde Ingenico epayments-account De MultiStore bestaat uit twee winkels die aan dezelfde website zijn gekoppeld en gebruikmaken van twee verschillende Ingenico epayments-accounts: Het voorbeeld is ook geldig wanneer beide winkels aan verschillende websites zijn gekoppeld: Winkel A opereert onder http://www.my-shop-a.com/ Winkel B opereert onder http://www.my-shop-b.com/ De juiste configuratie voor winkel A in de Ingenico epayments-backoffice is de volgende: Direct HTTP server-to-server request: http://www.my-shop-a.com/ops/api/postback HTTP request for status changes: http://www.my-shop-a.com/ops/api/directlinkpostback De juiste configuratie voor winkel B in de Ingenico epayments-backoffice is de volgende: Direct HTTP server-to-server request: http://www.my-shop-b.com/ops/api/postback HTTP request for status changes: http://www.my-shop-b.com/ops/api/directlinkpostback Page 17 of 22-28/03/2019

6. Betalingsworkflow Page 18 of 22-28/03/2019

Page 19 of 22-28/03/2019

Page 20 of 22-28/03/2019

7. Ingenico epayments/magento status mapping Download een overzicht van alle Ingenico epayments statussen t.o.v. Magento statussen (xlsx-bestand). Download een kopie van de Payment staat handling. Page 21 of 22-28/03/2019

8. Veelgestelde vragen In geval van vragen of problemen kunt u een kijkje nemen op http://ingenico.support.netresearch.de/support/solutions Als u daar geen antwoord vindt, neem dan contact op met support@ecom.ingenico.com Page 22 of 22-28/03/2019