Inhoudsopgave. 1. Inleiding. 2. Een Alias aanmaken. 3. Gebruik van de Alias. 4. Aliasbeheer. 2.1 e-commerce. 2.2 DirectLink. 2.

Vergelijkbare documenten
2016 KBC CBC PAYPAGE. Alias Manager

One Page Checkout / Alias Gateway

2016 KBC CBC PAYPAGE. e-terminal

1. Inleiding. e-terminal

Handleiding American Express

Handleiding Maestro. door Patricia Sturm 29 september Versie 1.1 Openbaar

Subscription Manager

Handleiding Bancontact

Een Testaccount Aanmaken en Configureren

Handleiding PayPal. door Patricia Sturm 2 november Versie 2.1 Openbaar

Inhoudsopgave. 1. Inleiding. 2. Integratiestroom. 3. Stap 1: Integratie met FlexCheckout. 4. Stap 2: Integratie met DirectLink

2016 KBC CBC PAYPAGE. User Manager

Handleiding IDEAL. door Patricia Sturm 27 september Versie 2.1 Openbaar

Uw Ogone Test Account aanmaken en configureren

Handleiding AfterPay. door Patricia Sturm 5 september Versie 2.5 Openbaar

Inhoudsopgave. 1. Inleiding. 2. Activering. 3. Gebruikersprofielen. 4. Soorten gebruikers. 5. Gebruikersbeheer. 3.1 Admin

Handleiding Giropay. door Patricia Sturm 13 september Versie 2.1 Openbaar

Handleiding Bankoverschrijving

Handleiding Klarna. door Patricia Sturm 27 september Versie 2.1 Openbaar

Ingenico. Handleiding Versie

MultiSafepay Payment plugin voor VirtueMart Copyright (C) 2011 multisafepay.com INLEIDING

Magento 1.4.x x module. Version 4.1.X

Bedrijven SEPA machtiging

1. Uploaden bestand. De SubID upload en download functionaliteit wordt getoond onder aan de SUBID management pagina onder merchant profiel.

Handleiding (Verzender Ontvanger)

Inhoudsopgave. 1. Disclaimer. 2. Installatie in PrestaShop. 3. Configuratie. 4. Modulegebruik - PrestaShop-backoffice

DirectLink with 3-D Secure

Functionaliteiten Triple Deal Payment Services

Uploaden/downloaden van bestanden met KBC/CBC-Paypage Batch (basis)

Hosted Tokenization Page

Deutsche Bank Global Transaction Banking. Internet Bankieren. Beheren.

Magento 1.4.x, 1.5.x, 1.6.x en 1.7.x module. Version 3.2

AFO 142 Titel Aanwinsten Geschiedenis

Handleiding voor de implementatie van de Buckaroo PSP plug-in voor

Aanvraagformulier voor het aanmaken van een e-payment PRODUCTIE account

In yoobi is het mogelijk om te koppelen met yuki. De volgende type koppelingen zijn hierbij beschikbaar:

Basic e-commerce. Technische integratiegids voor e-commerce Versie 1.3

Deutsche Bank Global Transaction Banking. Internet Bankieren. Betalingen en incasso s invoeren.

SEOshop. Installatie- & gebruikershandleiding

Car-Pass versie 7_1_0

Testen in de testomgeving Rabo OnlineKassa

15 July Betaalopdrachten web applicatie gebruikers handleiding

Gift & Loyalty card. User Guide v2.1 NL Schema Eigenaar. Laatste update : Mei 2014

Handleiding Faxdiensten

Handleiding Webapplicatie Robin

Uploaden/downloaden van bestanden met ConCardis Batch (basis)

Uploaden/downloaden van bestanden met Ingenico epayments Batch (basis)

Beschrijving van de functies van de MOBILEbanking-app

In het CMS is het mogelijk om formulieren aan te maken. Voorafgaand een belangrijke tip:

ideal Betaal Formulier (Ondersteund o.a. ideal, MisterCash, Direct E-Banking en Credit Card)

Inhoudsopgave. 1. Inleiding. 2. Configuratie. 3. Een nieuw rapport maken. 4. Rapporten beheren

Handleiding Formulieren in TYPO3 Versie 1.2, 18 juli 2008

Deutsche Bank Global Transaction Banking. Internet Bankieren. Betalingen en incasso s invoeren.

Installatie Handleiding. MyParcel plug-in

Inhoud. Populaire onderwerpen

Shell Card Online e-invoicing Service Gebruikershandleiding. Versie 2.8

Handleiding DSB Internet Banking

Handleiding PrestaShop - factuursturen.nl

Opslag van Creditcard Gegevens if you don t need it, don t store it

Handleiding gebruiker CKO2

Handleiding DocZend. Versie 1.2 januarie Copyright KPN Lokale Overheid

SEOSHOP KLANTENSCORES.NL APP

8.1.1 Aanmaken van een nieuwsbrieflijst voor een nieuwsbrief

Augustus Handleiding Subsidieportaal Uitvoering Van Beleid

Handleiding. Online subsidie Vlabinvest aanvragen. Greet Matthijs Projectleider ICT. april 2018

Kluwer Office. DMS Basic Medewerker. Software.kluwer.be

Handleiding Sepa Direct Debit

Meest gestelde vragen BESTELLEN VIA MYHERBALIFE.COM BELGIE, JANUARI 2014

Gebruikershandleiding. Beheer Enveloppen

2) Aan welke voorwaarden moet het CSV bestand voldoen om geïmporteerd te kunnen worden?

MultiSafepay handleiding

Handleiding my.tentoo voor opdrachtgevers

Instructies interface KNLTB Versie 0.1

Bulk-upload voor gebruikers IRON MOUNTAIN CONNECT RECORDS MANAGEMENT

Handleiding : Opdrachten vanuit Excel

In de tabel hieronder vindt u een beschrijving van de verschillende velden die kunnen voorkomen in uw import-bestand.

Les 15 : updaten van gegevens in de database (deel2).

General info on using shopping carts with Ingenico epayments

CARGO DATA SYSTEMS BV DE OPLOSSING VOOR TOTALE EXPEDITIE EN TRANSPORT AUTOMATISERING. Elektronisch factureren CDS

#Stap 1 Uw account activeren en inloggen

Snel aan de slag met

Gebruikers handleiding Brugge Printshop webshop

Handleiding internet bestellen voor Top Bakkers klanten

Handleiding EMS Reports

Instructie voor het accepteren van PayPal betalingen

Integratie met Ogone DirectLink (server-to-server)

1 Handleiding. Total Cards Online. Handleiding

DYNAPLUG 1. Praktische handleiding. DYNAPLUG: eenvoudig online bestellen bij Van Hoecke 2. Hoe gaat u te werk? 2

Deutsche Bank Global Transaction Banking. Internet Bankieren. Recente verbeteringen. Versie januari 2014

GEBRUIK VAN QNAP-BTB

Welkom bij Digicel Online Top Up

Transactiestatussen- en fouten

Handleiding gebruik Citymail

Handmatige invoer NHR datasets 2018 Pacemaker- en ICD registratie. Definitief / 16 augustus 2018 / versie

Handleiding Salariscentrum.nl

Bulkfacturatie. Functioneel ontwerp uitbreiding Coachview.net. Dé nieuwe manier van samenwerken

Saferpay. D Het veiligste betaalsysteem voor uw onlineshop ie

Voordat u gebruik kunt maken van ZorgMail in Intramed, zijn een aantal instellingen nodig:

ONLINE CV- EN VACATUREPRESENTATIE HANDLEIDING. OTYS Recruiting Technology

Transcriptie:

Inhoudsopgave 1. Inleiding 2. Een Alias aanmaken 2.1 e-commerce 2.1.1 Extra verborgen velden 2.1.2 Beveiliging: SHA-handtekening (controle voor de betaling) 2.1.3 Transactiefeedback aan de merchant 2.2 DirectLink 2.2.1 Aanvullende verzoekparameters 2.2.2 Beveiliging: SHA-handtekening (controle voor de betaling) 2.2.3 Transactieantwoord 2.3 Batch 2.4 Alias Manager 3. Gebruik van de Alias 3.1 e-commerce 3.1.1 Alias-update 3.2 DirectLink 3.2.1 Alias-update 3.3 Batch 3.3.1 Alias-update 3.4 e-terminal 3.4.1 Alias-update 3.5 Fouten 4. Aliasbeheer Page 1 of 15-12/09/2017

5. Speciale toepassingen 5.1 e-wallet 5.2 Geoptimaliseerd aliasbeheer 5.2.1 Voorbeeld met "BYMERCHANT" (of leeg) 5.2.2 Voorbeeld met "BYPSP" 6. Appendix: Bulk Alias-aanmaak via Batch 6.1 Overzicht 6.2 Aanmaak 6.3 Verwijderen Page 2 of 15-12/09/2017

1. Inleiding De Alias Manager biedt functies voor periodieke facturering (betaling van periodiek gefactureerde diensten) en andere specifieke toepassingen met kaartnummeraliassen (opslag van klantenprofielen op uw website bijvoorbeeld). Een alias is een identificatie voor een kaartnummer en de vervaldatum van de kaart en kan gebruikt worden om andere betalingen in de toekomst aan te vragen. Deze alias wordt aan een enkele merchant gekoppeld en kan niet door een derde gebruikt worden. Dankzij de Alias Manager voor periodieke facturering (recurring) hoeven merchants die Batch, DirectLink en/of e-terminal gebruiken de financiële gegevens van hun klanten na de eerste betaling niet op te slaan. Merchants die e-commerce gebruiken, hoeven nooit in contact te komen met de financiële gegevens van hun klanten of hen op te slaan. Dit beperkt de risico s en investeringen met betrekking tot de veilige opslag van de financiële gegevens van klanten. De Alias Manager laat het gebruik van een veilig periodiek factureringssysteem toe zonder dat de merchant zijn systeem PCI-compatibel hoeft te maken. Zelfs wanneer de Alias Manager in uw account actief is, kunt u nog altijd transacties uitvoeren zonder een alias te specificeren. Wanneer u in de e-commerce-modus werkt, vragen we de klant of zijn financieel profiel opgeslagen mag worden. Aangezien ons systeem in overeenstemming is met de wetgeving betreffende de persoonlijke levenssfeer, kan een kaarthouder ons weigeren om zijn financieel profiel op te slaan. In dat geval kan de merchant beslissen om de transactie af te breken als de aanmaak van een alias cruciaal is. Deze beperking is niet van toepassing op de andere modi, waarbij de merchant zelf de financiële gegevens van de kaarthouder invoert. Dit document beschrijft de integratie van de optie Alias Manager" in de toepassing van de merchant (e-commerce / DirectLink / Batch / e-terminal). Deze optiehandleiding moet samen met de integratiehandleidingen van e-commerce / DirectLink / Batch / e-terminal gelezen worden. Page 3 of 15-12/09/2017

2. Een Alias aanmaken U kunt een alias aanmaken door een transactie uit te voeren via e-commerce, DirectLink of Batch. Daarnaast kunt u ook handmatig (via e-terminal) een alias aanmaken op de Alias management-pagina. U kunt ook geen tekenreeks van cijfers met meer dan 14 tekens beginnend met 2, 3, 4, 5 of 6 gebruiken die op een kaartnummer lijkt. Dit wordt geblokkeerd door ons syteem, omwille van het onveilige aspect om niet-geëncrypteerde kaartnummers in ons systeem op te slaan. De mogelijkheid om met een alias te werken voor periodieke facturering en andere specifieke toepassingen, hangt af van de betaalmethodes die u wenst te gebruiken. Zie de online betalingsmethoden Processing / Procedure overzichtspagina. Opmerkingen over PayPal en PostFinance Card: Aangezien deze betaalmethoden een authenticatie van de kaarthouder vragen, is het alleen mogelijk om een alias aan te maken met gebruik van e-commerce. Het minimum bedrag voor de PostFinance Card is CHF 0.05. 2.1 e-commerce De procedure voor het aanmaken van een alias in de e-commerce-modus is bijna identiek aan die van een normale e-commerce-transactie. Het grootste technische verschil ligt in de wijzigingen die uitgevoerd moeten worden bij de controle voor de betaling. 2.1.1 Extra verborgen velden Om een alias via e-commerce aan te maken, moet u de volgende extra verborgen velden doorsturen: Veld Verklaring ALIAS Alias voorgesteld door de merchant ALIASUSAGE Een tekst die de reden voor de aliasregistratie opgeeft Na het verzenden van de verborgen velden wordt de veilige betaalpagina aan de klant getoond. Daar kan hij zijn betaalmethode kiezen en zijn betalingsgegevens invoeren. Ook de tekst die u in het ALIASUSAGE-veld hebt doorgestuurd, wordt weergegeven. Het dialoogvenster bevat een selectievakje dat de klant kan aan- of uitvinken om zijn toestemming te geven of te weigeren voor de opslag van zijn financieel profiel. Indien niet aangevinkt, dan kunt u als merchant het transactieproces automatisch stopzetten. Dit kunt u op de Alias Management-pagina instellen (via "Configuratie" > "Alias" in het backofficemenu). Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan maken wij het financieel profiel (alias) in onze aliasdatabase aan. 2.1.2 Beveiliging: SHA-handtekening (controle voor de betaling) U moet de alias-parameters (ALIAS and ALIASUSAGE) gebruiken in de berekening van de SHA signature. Page 4 of 15-12/09/2017

Voor meer details, ga naar e-commerce. 2.1.3 Transactiefeedback aan de merchant Als u na de transactie feedback-requests ontvangt, of feedbackparameters op een redirectie, dan zult u een extra parameter ontvangen: ALIAS. Als u een SHA-OUT-handtekening voor deze feedback-requests hebt ingesteld, dan moet u de ALIAS-parameter in acht nemen voor uw handtekening. 2.2 DirectLink 2.2.1 Aanvullende verzoekparameters Om tijdens een transactie via DirectLink een alias aan te maken, moet u naast de andere transactievelden ook de volgende velden doorsturen: Veld Beschrijving ALIAS Alias voorgesteld door de merchant CARDNO ED Vervaldatum CN Naam kaarthouder Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan maken wij het financieel profiel (alias) in onze aliasdatabase aan. Voor Direct Debits moet het rekeningnummer in het veld CARDNO worden meegezonden, de vervaldatum mag niet worden verzonden. 2.2.2 Beveiliging: SHA-handtekening (controle voor de betaling) U moet de alias parameters (ALIAS and ALIASUSAGE) gebruiken in de berekening van de SHA-handtekening. Voor meer details, ga naar e-commerce. 2.2.3 Transactieantwoord Het XML antwoord op uw verzoek zal de extra parameter ALIAS bevatten. 2.3 Batch Om tijdens een transactie via Batch een alias aan te maken, moet u naast de andere transactievelden ook de volgende velden doorsturen: Veld Veldnummer ALIAS 17 CN 4 ED 5 CN 8 Page 5 of 15-12/09/2017

Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan maken wij het financieel profiel (alias) in onze aliasdatabase aan. 2.4 Alias Manager Aliassen kunnen handmatig in het backoffice geregistreerd worden: 1. 2. 3. 4. Ga naar "Configuratie" > "Alias" in het menu van uw account om de Alias Management-pagina te openen. Klik op de tab "Aanmaken" om een nieuwe alias te registreren. Voer de aliasnaam en de financiële gegevens in: naam kaart/rekeninghouder, kaartnummer en vervaldatum (indien van toepassing) Klik op de knop Aanmaken. Let op dat deze methode alleen mogelijk is voor creditcards en Direct Debits. Het is niet mogelijk om een nieuwe allias te registreren voor PayPal en PostFinance Card. Aangezien de alias handmatig aangemaakt wordt in plaats van via een transactie, maken wij het financieel profiel (alias) niet onmiddellijk in onze aliasdatabase aan. Wij kunnen het financieel profiel pas in onze database invoeren wanneer een transactie met de alias door de financiële instelling aanvaard is, m.a.w. nadat de betalingsgegevens officieel gecontroleerd zijn. Page 6 of 15-12/09/2017

3. Gebruik van de Alias De mogelijkheid om met een Alias te werken voor periodieke facturering en andere specifieke toepassingen hangt af van de betaalmethodes die u wenst te gebruiken. 3.1 e-commerce Om een bestaande ALIAS te gebruiken, kunnen of moeten de volgende verborgen velden meegestuurd worden in uw request: Veld Omschrijving Verplicht ALIAS De naam van de ALIAS die u wilt gebruiken. Wij controleren dan of de ALIAS voor uw PSPID al bestaat. J ALIASUSAGE Stuur een waarde met dit veld enkel als u een andere tekst aan de klant wilt tonen dan degene die u initieel had gestuurd bij het aanmaken van de alias. N ECI ECI-waarde "9" moet gestuurd worden bij wederkerende transacties J Als de ALIAS bestaat, dan worden de naam van de kaarthouder, het gemaskeerde creditcardnummer en de vervaldatum op de betaalpagina geïnitialiseerd. 3.1.1 Alias-update Als de kaarthouder de vooraf ingestelde gegevens niet wijzigt en gewoon op de knop Verzenden klikt, dan zoeken we het financieel profiel (gebaseerd op de ALIAS) in de database op. Indien hij bepaalde gegevens, zoals de vervaldatum, wil bijwerken, kan de kaarthouder de geïnitialiseerde velden wijzigen. Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan zullen we de financiële gegevens van de klant bijwerken. Voor meer informatie over de controle voor de betaling en feedback-requests na de transactie, raadpleeg Alias aanmaken via e-commerce. 3.2 DirectLink Om een bestaande ALIAS te gebruiken, moeten de volgende velden meegestuurd worden in uw request: Veld Omschrijving ALIAS De naam van de ALIAS die u wilt gebruiken. Wij controleren dan of de ALIAS voor uw PSPID al bestaat. ECI ECI-waarde "9" moet gestuurd worden bij wederkerende transacties Als de ALIAS bestaat, dan worden de naam van de kaarthouder, het gemaskeerde creditcardnummer en de vervaldatum op de betaalpagina geïnitialiseerd. 3.2.1 Alias-update Als u ons gewoon de ALIAS doorstuurt (geen nieuw creditcardnummer, vervaldatum, naam kaarthouder), dan zoeken wij het financieel profiel (gebaseerd op de ALIAS) in de database op. Naast de ALIAS-parameter kunt u ons ook een nieuw creditcardnummer, vervaldatum of naam van de kaarthouder doorsturen om de bestaande ALIAS bij te werken. Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan zullen we de Page 7 of 15-12/09/2017

financiële gegevens van de klant bijwerken. 3.3 Batch Om een bestaande ALIAS te gebruiken, moet u de volgende velden meesturen in het bestand: Veld Omschrijving Veldnr. ALIAS De naam van de ALIAS die u wilt gebruiken. Wij controleren dan of de ALIAS voor uw PSPID al bestaat. 17 ECI ECI-waarde "9" moet gestuurd worden bij wederkerende transacties. 35 3.3.1 Alias-update Als u ons de ALIAS doorstuurt, dan zoeken wij het financieel profiel (gebaseerd op de ALIAS) in de database op. Naast het ALIAS-veld kunt u ons ook een nieuw creditcardnummer, vervaldatum of naam van de kaarthouder doorsturen om de bestaande ALIAS bij te werken. Als de transactie op ons platform met succes verwerkt wordt (niet in status 0 of 1), dan zullen we de financiële gegevens van de klant bijwerken. 3.4 e-terminal Om een alias te gebruiken via e-terminal volgt u deze stappen: 1. 2. 3. Klik in het backofficemenu op de Alias link Zoek de alias die u wilt gebruiken op in de Alias Management-pagina Klik op de knop Gebruiken. De e-terminal voucher wordt weergegeven met de geïnitialiseerde naam van de kaarthouder, het kaartnummer en de vervaldatum. 3.4.1 Alias-update U kunt enkel de vervaldatum wijzigen op de voucher. De geïnitialiseerde naam van de kaarthouder en het kaartnummer kunnen niet op de voucher gewijzigd worden. 3.5 Fouten Als bij een transactie een alias wordt verzonden, maar ons systeem de alias niet kan vinden (meestal wanneer de alias niet bestaat), worden de volgende foutcode en foutmelding geretourneerd: Retourveld Waarde NCERROR 50001111 (Gegevensvalidatiefout) NCERRORPLUS Alias "..." not Found (niet gevonden) Page 8 of 15-12/09/2017

4. Aliasbeheer Klik op "Configuratie" > "Alias" in uw back-officemenu om toegang te krijgen tot uw Aliasbeheerpagina. Deze pagina bevat de volgende onderdelen: Mijn aliasgegevens: Status: Aantal actieve aliassen (aanklikbaar om een lijst te bekomen van de betreffende aliassen) Aantal aliassen met bijna verlopen creditcardgegevens (aanklikbaar om een lijst te bekomen van de betreffende aliassen) Aantal aliassen die werden verwijderd in de huidige kalendermaand Aantal actieve aliassen in de vorige kalendermaand Algemene parameters: Hier configureert u: of het opt-in/out selectievakje op de betaalpagina al dan niet is aangevinkt. De kaarthouder kan alsnog kiezen zijn kaartgegevens al dan niet te bewaren door het vakje aan/uit te vinken. of een transactie moet geweigerd worden als de kaarthouder kiest om zijn gegevens niet te laten bewaren, en dus geen alias te laten aanmaken de bewaartermijn: hoeveel maanden een alias moet bewaard worden (tussen 3 en 60 maanden/5 jaar). Deze periode wordt na elk gebruik geherinitialiseerd. Hosted Tokenization Page: hier geeft u aan of u de op-in/out checkbox wilt weergeven op de Hosted Tokenization-pagina (optioneel). Aliaslijst, voor het raadplegen en downloaden, opzoeken, gebruiken, wijzigen en verwijderen van aliassen. Aanmaken, voor het manueel aanmaken van nieuwe aliassen. Page 9 of 15-12/09/2017

5. Speciale toepassingen Dit hoofdstuk geeft meer uitleg over specifieke, geavanceerde aliastoepassingen die een hoger niveau van integratie vereisen. Deze toepassingen zijn niet van toepassing voor periodieke (recurring) betalingen. De mogelijkheid om met een Alias te werken voor periodieke facturering en andere specifieke toepassingen hangt af van de betaalmethodes die u wenst te gebruiken. 5.1 e-wallet U kunt geregistreerde klanten een e-wallet van creditcards geven zonder dat u hun financiële gegevens hoeft te beheren. U maakt een nieuwe alias aan voor de eerste betaling van een nieuwe klant. Wanneer de klant uw website opnieuw bezoekt, kunt u de gemaskeerde kaart(en) die aan zijn alias(sen) gekoppeld zijn op de achtergrond (in uw HTML-code) weergeven. De eenvoudigste manier om de gemaskeerde kaartnummers te registreren, is hen te onttrekken uit de feedbackparameters die we u na elke transactie doorsturen (e-commerce). Voorbeeld van een e-wallet: <select name= cards > <option value= alias284 >VISA XXXXXXXXXXXX1111</option> <option value= alias128 >MasterCard XXXXXXXXXXXX9999</option> <option value= alias389 >Use a new card</option> </select> Wanneer de klant (een van) zijn gemaskeerde kaart(en) op uw website selecteert, wordt de gekoppelde alias naar ons doorgestuurd in uw verborgen velden. U kunt nog altijd de keuze Andere kaart aanbieden om het aanmaakproces van een nieuwe alias op te starten. 5.2 Geoptimaliseerd aliasbeheer Wanneer u de Alias Manager met e-commerce of DirectLink gebruikt, kunt u ook een extra veld/parameter (ALIASOPERATION) doorsturen. Veld Mogelijke waarden ALIASOPERATION Leeg (of BYMERCHANT) BYPSP Wanneer u een toekomstige nieuwe klant hebt, moet u een nieuwe alias aanmaken. De kaart die tijdens de transactie gebruikt zal worden, is misschien voordien al op uw website gebruikt en komt dan overeen met een al bestaande alias. ALIASOPERATION BYPSP kan gebruikt worden om de aanmaak van dubbele aliassen voor dezelfde kaart te voorkomen. Om een nieuwe alias aan te maken kunt u het aliasveld leeg laten en ALIASOPERATION BYPSP doorsturen. Ons systeem zal dan controleren of er al een alias voor het kaartnummer bestaat en zal enkel een nieuwe alias aanmaken als dat nodig is. Als het gebruikte kaartnummer overeenstemt met een al bestaande alias, dan zal er geen nieuwe alias aangemaakt worden en zal de betaling aan de gevonden alias gekoppeld worden. Wanneer u een aliaswaarde in het ALIAS-veld/parameter doorstuurt (d.i. een alias gebruikt) en BYPSP als ALIASOPERATION, dan controleren wij of de ontvangen financiële gegevens overeenstemmen met een bestaande alias. Als de klant zijn creditcardgegevens tijdens de transactie gewijzigd heeft, dan zullen onze feedbackparameters/xml-response een andere Page 10 of 15-12/09/2017

alias bevatten dan die u naar ons hebt doorgestuurd. De teruggestuurde alias in de feedbackparameters/xml-response komt overeen met een al bestaande alias voor het nieuwe kaartnummer of een nieuwe alias die door ons systeem is aangemaakt. Als uw processen aliassen vereisen die aan het OrderID gekoppeld zijn (een nieuwe alias voor elk order), dan moet de ALIASOPERATIONparameter leeg gelaten worden (of op de waarde BYMERCHANT ingesteld worden). In de onderstaande tabel vindt u een overzicht van de mogelijkheden van beide ALIASOPERATION-waarden voor het aanmaken en gebruiken/bijwerken van uw aliassen. U kunt een andere ALIASOPERATION gebruiken om uw aliassen aan te maken en te gebruiken/bij te werken. Op die manier kunt u uw Alias Management optimaliseren naargelang uw specifieke behoeften. ALIASOPERATION Leeg (of BYMERCHANT) BYPSP Verzonden op het moment van de aanmaak van de alias Merchant kiest de aliasnamen. Mogelijkheid om een nieuwe alias voor elk order aan te maken. Ons systeem kiest de aliasnamen.. Ons systeem maakt enkel een nieuwe alias aan als het kaartnummer nog niet aan een andere alias gekoppeld is.. Verzonden op het moment van het gebruik of de update van de alias (Alias verzonden in het ALIAS-veld) Eén alias per klant: als de klant zijn creditcardgegevens tijdens de transactie wijzigt, dan zal de alias met de nieuwe gegevens bijgewerkt worden. Eén alias per creditcard: als de klant zijn creditcardgegevens tijdens de transactie wijzigt, dan zal er een nieuwe alias aangemaakt worden. 5.2.1 Voorbeeld met "BYMERCHANT" (of leeg) Gegevens in onze aliasdatabase: Alias A14352 41111 B76985 53999 Voorbeeld 1 : Verzonden Alias : A14352 Gebruikte kaart : 37411 Ontvangen Alias : A14352 Gegevens in onze aliasdatabase: Alias A14352 37411 B76985 53999 Voorbeeld 2 : Verzonden Alias : C01203 Page 11 of 15-12/09/2017

Gebruikte kaart : 53999 Ontvangen Alias : C01203 Gegevens in onze aliasdatabase: Alias A14352 41111 B76985 53999 C01203 53999 5.2.2 Voorbeeld met "BYPSP" Gegevens in onze aliasdatabase: Alias XXXXXXXX-CA55-4995-B4F0-C3424AB2C2BA 41111 YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA 53999 Voorbeeld 1: Verzonden Alias: XXXXXXXX-CA55-4995-B4F0-C3424AB2C2BA Gebruikte kaart: 37411 Ontvangen Alias: ZZZZZZZZ-CA55-4995-B4F0-C3424AB2C2BA Gegevens in onze aliasdatabase: Alias XXXXXXXX-CA55-4995-B4F0-C3424AB2C2BA 41111 YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA 53999 ZZZZZZZZ-CA55-4995-B4F0-C3424AB2C2BA 37411 Er werd een nieuwe Alias aangemaakt, omdat de gebruikte kaart al in de database aanwezig was en de verzonden Alias al aan een ander kaartnummer gekoppeld was. In het geval van "ALIASOPERATION: leeg (of BYMERCHANT)" zou de bestaande Alias met het verzonden kaartnummer bijgewerkt worden. Voorbeeld 2: Verzonden Alias: ledig Gebruikte kaart: 53999 Ontvangen Alias: YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA Gegevens in onze aliasdatabase: Alias Page 12 of 15-12/09/2017

Alias XXXXXXXX-CA55-4995-B4F0-C3424AB2C2BA 41111 YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA 53999 ZZZZZZZZ-CA55-4995-B4F0-C3424AB2C2BA 37411 Omdat de gebruikte kaart al aan een bestaande Alias gekoppeld was, werd de verzonden Alias niet aangemaakt en werd de bestaande Alias gebruikt. In het geval van "ALIASOPERATION: leeg (of BYMERCHANT)" zou de nieuwe Alias met het verzonden kaartnummer aangemaakt worden, waardoor de database twee aliassen met hetzelfde kaartnummer zou bevatten. Voorbeeld 3: Verzonden Alias: ZZZZZZZZ-CA55-4995-B4F0-C3424AB2C2BA Gebruikte kaart: 53999 Ontvangen Alias: YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA Gegevens in onze aliasdatabase: Alias XXXXXXXX-CA55-4995-B4F0-C3424AB2C2BA 41111 YYYYYYYY-CA55-4995-B4F0-C3424AB2C2BA 53999 ZZZZZZZZ-CA55-4995-B4F0-C3424AB2C2BA 37411 Omdat de gebruikte kaart al aan een (andere) bestaande Alias gekoppeld was en de verzonden Alias al bestond, werd de Alias gebruikt die met het kaartnummer overeenstemt. In het geval van "ALIASOPERATION: leeg (of BYMERCHANT)" zou de bestaande Alias met het verzonden kaartnummer bijgewerkt worden, waardoor de database twee aliassen met hetzelfde kaartnummer zou bevatten. Page 13 of 15-12/09/2017

6. Appendix: Bulk Alias-aanmaak via Batch 6.1 Overzicht Het doel van Bulk Alias-aanmaak via Batch is om meerdere aliassen in een keer aan te maken, zonder transacties uit te voeren. De merchant dient de batchbestanden in "BYMERCHANT"-modus te verstrekken, inclusief de Alias ID. De batchbestanden kunnen zowel manueel als automatisch worden geüpload, via een http-request op het Ingenico epayments platform. Dit kan synchroon of asynchroon gedaan worden, hoewel we aanraden om de bestanden asynchroon te behandelen indien deze meer dan 100 records bevatten. Op deze manier worden er geen transacties uitgevoerd. Een format check zorgt ervoor dat de creditcard- of rekeningnummers correct zijn, zonder dat een autorisatie wordt uitgevoerd. Dit heeft als gevolg dat er geen zekerheid is of de kaart/rekening nog geldig is. Als de vervaldatum van een creditcard in het verleden ligt, voegt ons systeem twee jaar toe, tot de datum in de toekomst ligt. Dit is een standaard proces bij het aanmaken van een alias. De merchant kan zijn bestanden voor aliasaanmaak op twee verschillende manieren uploaden: 1. 2. Handmatig: de merchant upload de bestanden manueel in zijn back-office (zie Basic Batch). Automatisch: de merchant voert de upload requests met een eigen applicatie uit via https, op specifieke pagina's op ons systeem (zie Advanced Batch). Voor meer informatie, ga naar Advanced Batch voor request URL en specifieke parameters. 6.2 Aanmaak Het bestand met het verzoek moet een ASCII tekstbestand zijn en mag slechts een lijn per alias bevatten. De velden dienen te worden gescheiden met een puntkomma (";") en de waarden zelf mogen geen puntkomma bevatten. Formaat: AN= Alfanumeriek / N=Numeriek, maximum aantal aanvaarde tekens Veld Formaat Voorbeeld 1 OPERATION AN, 8 ADDALIAS 2 ALIAS AN, 50 Customer123 3 CN AN, 35 John Doe 4 CARDNO AN, 21 XXXXXXXXXXXX1111 5 EXPDATE MMYY 1012 6 BRAND AN, 25 VISA 7 PSPID AN, 30 JDoeSHOP Voorbeeld met creditcard: ADDALIAS;Customer123;John Doe;XXXXXXXXXXXX1111;1015;VISA;JDoeSHOP; Page 14 of 15-12/09/2017

Voorbeeld met Direct Debits: ADDALIAS;Customer123;John Doe;XXXXXXXXXXXX1111;1015;VISA;JDoeSHOP; 6.3 Verwijderen Het bestand met het verzoek moet een ASCII tekstbestand zijn en mag slechts een lijn per alias bevatten. De velden dienen te worden gescheiden met een puntkomma (";") en de waarden zelf mogen geen puntkomma bevatten. Formaat: AN= Alfanumeriek / N=Numeriek, maximum aantal aanvaarde tekens Veld Formaat Voorbeeld 1 OPERATION A, 8 DELALIAS 2 ALIAS AN, 50 Customer123 Voorbeeld: DELALIAS;Customer123;;;;;; (alle puntkomma's aan het eind moeten toegevoegd worden!) Automatische file upload: Om de verwijdering van een alias tot stand te brengen is een bestand met het volgende formaat nodig: OHL;PSPID;API PASSWORD;;USER API; DELALIAS;ALIAS VALUE;;;;;; DELALIAS;ALIAS VALUE;;;;;; OTF; Wij raden aan om checkandprocess (controleren en verwerken) te gebruiken en alleen aliassen van dezelfde PSPID te vermelden. Voor meer informatie over de verschillende automatische upload processen, ga naar Advanced Batch. Page 15 of 15-12/09/2017