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

Transcriptie

1

2 Inhoudsopgave 1. Inleiding 2. Integratiestroom 3. Stap 1: Integratie met FlexCheckout 3.1 Invoervelden Controleren op dubbele OrderID 3.2 SHA-handtekening voor invoer 3.3 Outputvelden 3.4 SHA-handtekening voor output 4. Stap 2: Integratie met DirectLink 5. Gebruik met Alias Manager Page 1 of 10-16/09/2016

3 1. Inleiding Via One Page Checkout met FlexCheckout kunt u uw klanten verzoeken hun kaartgegevens veilig op het PSP-systeem in te voeren, de gegevens tokeniseren en (optioneel) de token/alias opnieuw gebruiken bij een toekomstige transactie: FlexCheckout: U leidt de FlexCheckout om naar een iframe of neemt de pagina daarin op; de kaartgegevens die de kaarthouder daar invoert, worden naar ons systeem verzonden, waar ze veilig worden opgeslagen (inclusief de CVC-code, zij het slechts kort) DirectLink: U verzendt de echte bestelling met de gegenereerde alias, zonder dat u de kaartgegevens hoeft te verzenden (vgl. integratie met DirectLink) Voordelen Dankzij het flexibele templatemechanisme hebt u volledige controle over de uitstraling van de betaalpagina, en als u de FlexCheckout in een Iframe opneemt, kunt u zelfs het afrekenproces beheren. U werkt met een veilige, PCI-compatibele betaalpagina en hoeft niet zelf de kaartgegevens op te slaan; alle gevoelige gegevens worden rechtstreeks ingevoerd op onze gehoste pagina. Bij gebruik van een iframe: Ogone is tijdens het betaalproces volledig onzichtbaar. Probleemloze integratie voor verschillende afrekenscenario's, inclusief One Page Checkout. Op de laatste afrekenpagina kunt up-selling en cross-selling aanbieden. Alle grote creditcardmerken (VISA, MasterCard, American Express, Diners) worden ondersteund. Page 2 of 10-16/09/2016

4 2. Integratiestroom Opmerking: Tijdens de eerste stap wordt er geen verrichting op de creditcard uitgevoerd. Ons systeem keurt alleen het basisformaat goed, maar kan niet garanderen dat de creditcard nog geldig is of over voldoende middelen beschikt om verder te gaan. Page 3 of 10-16/09/2016

5 3. Stap 1: Integratie met FlexCheckout U kunt de FlexCheckout op twee manieren gebruiken: U kunt de klant rechtstreeks omleiden naar de hosted tokenization-pagina U kunt de FlexCheckout opnemen in een Iframe, zodat de klant op uw pagina kan blijven en daar ook kan afrekenen De klant moet op de FlexCheckout altijd zijn kaartgegevens invoeren. Daardoor worden de kaartgegevens nooit via uw eigen webserver verzonden. De URL's voor de FlexCheckout zijn: Test: Production: De FlexCheckout werkt standaard met UTF-8-tekencodering. Wilt u in ISO werken, zorg er dan voor dat de "Karaktercodering" correct is geconfigureerd in uw backoffice: Configuratie > Technische instellingen > Algemene beveiligingsparameters > Hasing-methode. 3.1 Invoervelden Veld Omschrijving Formaat Verplicht ACCOUNT.PSPID Identificatie van merchant AN, 30 Ja ALIAS.ALIASID Klantalias AN, 50 Nee ALIAS.ORDERID Identificatie van bestelling AN, 40 Nee Geef aan of u een alias tijdelijk of permanent wilt opslaan. De mogelijke waarden zijn: ALIAS.STOREPERMANENTLY "N": de alias wordt na 2 uur verwijderd "Y": de alias wordt permanent opgeslagen, voor toekomstig gebruik Y / N Nee > Raadpleeg de kader onder deze tabel voor meer informatie. Geef aan welk type formulier moet worden CARD.BRAND weergegeven > Verplicht als geen "PaymentMethod" is opgegeven AN, 25 Ja/Nee CreditCard of DirectDebit - Geef aan welk type CARD.PAYMENTMETHOD formulier moet worden weergegeven > Verplicht als geen "Brand" is opgegeven AN, 26 Ja/Nee Page 4 of 10-16/09/2016

6 Veld Omschrijving Formaat Verplicht LAYOUT.LANGUAGE Taal die op de pagina wordt gebruikt ("en_en", "nl_be", "fr_fr" enz.) AN, 5 Nee PARAMETERS.ACCEPTURL URL voor omleiding indien succesvol AN, 255 Ja PARAMETERS.EXCEPTIONURL URL voor omleiding indien mislukt AN, 255 Ja Lijst van betaalmethoden en/of creditcardmerken die PARAMETERS.EXCLUDEDPAYMENTMETHODS NIET mogen worden getoond. Gescheiden door ';' (puntkomma). AN, 50 Nee PARAMETERS.PARAMPLUS Pass-Through-veld: Door de merchant te verzenden aanvullende parameters die in de output moeten worden opgehaald AN, 1000 Nee SHASIGNATURE.SHASIGN Reeks gehasht met behulp van het beveiligde hashalgoritme. AN, 128 Ja Alias.StorePermanently: Belangrijke opmerkingen Deze parameter mag alleen worden gebruikt in combinatie met Alias Manager. Standaard wordt de alias permanent opgeslagen. Als u een geïntegreerde one-page-checkout gebruikt, adviseren we u met klem om de optie "opt-in/out checkbox" in uw Alias Managerconfiguratie, in te schakelen, zodat op de FlexCheckout altijd het selectievakje wordt weergegeven. Als u de "opt-in/out checkbox"-optie in de configuratie van uw Alias Manager heeft ingeschakeld, krijgt dit voorrang op het gebruik van de parameter Alias.StorePermanently Controleren op dubbele OrderID Om te voorkomen dat hackers kaartgegevens vervangen die aan een specifiek token zijn gekoppeld (door de link om het verzoek te activeren vast te krijgen en de kaartgegevens te vervangen door echte kaartgegevens van een echte kaart), controleren we de OrderID (ALIAS.ORDERID) die u in het verzoek verzendt. Als we constateren dat de OrderID al eens is gebruikt om een token te maken, wordt de alias niet bijgewerkt. Belangrijk De controle van de OrderID werkt uiteraard alleen als de OrderID (ALIAS.ORDERID) wordt verzonden. Desondanks is de OrderID alleen niet voldoende; ook de AliasID (ALIAS.ALIASID) moet worden verzonden. Als de AliasID niet wordt verzonden, wordt de controle niet uitgevoerd en wordt een nieuwe alias aangemaakt. Na detectie van een dubbele OrderID wordt het verzoek geblokkeerd en ziet de klant een algemene foutmelding: "Bij de verwerking van uw verzoek is een fout opgetreden. Probeer het later opnieuw of neem contact op met uw merchant." Fouten die worden gegenereerd door een dubbele OrderID kunnen worden vastgesteld als de foutopsporingsmodus in de Foutlogs is geactiveerd (neem hiervoor contact op met ons Customer Care team). Page 5 of 10-16/09/2016

7 3.2 SHA-handtekening voor invoer Om de integriteit van de gegevens te controleren, verlangen we dat alle verzoeken vergezeld gaan van een SHA-handtekening, op dezelfde wijze als bij e-commerce transacties. Ons systeem maakt gebruik van het SHA-algoritme zoals gedefinieerd op het tabblad 'Algemene beveiligingsparameters' van de pagina 'Technische informatie'. Voorbeeld Velden (in alfabetische volgorde): Parameters.AcceptUrl: Parameters.ExceptionUrl: Account.PspId: test1 Card.Brand:VISA Geheime wachtzin (zoals gedefinieerd in Technische instellingen): Mysecretsig1875!? Tekenreeks om te hashen: ACCOUNT.PSPID=test1Mysecretsig1875!?CARD.BRAND=VISAMysecretsig1875!?PARAMETERS.ACCEPTURL= /ok.htmlmysecretsig1875!?parameters.exceptionurl= Resulterende SHA-handtekening (SHA-1): 432D78B6977AA913C4F96B89C1D216073E7E6A Outputvelden De volgende velden kunnen naar u worden teruggestuurd in verband met de status van de aanmaak/bijwerking van de alias. Om de velden in de feedback op te nemen, moeten ze dienovereenkomstig worden geconfigureerd in de dynamische feedbackparameters (Ogone-account: Configuratie > Technische instellingen > Transactiefeedback > Alias gateway en Tokenization: Dynamische parameters). De SHASIGN is niet optioneel en wordt daarom altijd teruggestuurd. Veld Omschrijving Max. Lengte ALIAS.ALIASID Door merchant verzonden of door PSP gegenereerde alias (volgens het 32-cijferig GUID-formaat). Voorbeeld: 34F5302C-85D7-4F35-BDF5-103CCEC2FB61 50 ALIAS.NCERROR Foutcode 50 ALIAS.NCERRORCARDNO Foutcode voor CARDNO 50 ALIAS.NCERRORCN Foutcode voor CN 50 ALIAS.NCERRORCVC Foutcode voor CVC 50 Page 6 of 10-16/09/2016

8 Veld Omschrijving Max. Lengte ALIAS.NCERRORED Foutcode voor ED 50 ALIAS.ORDERID Het unieke identificatienummer van de bestelling. (verzonden door de merchant of gegenereerd door het systeem) 40 ALIAS.STATUS Resultaat van het aanmaken van de alias: 0=OK 1=NOK 2=Alias bijgewerkt 3=Geannuleerd door gebruiker 1 ALIAS.STOREPERMANENTLY Geeft de keuze aan of de alias tijdelijk (N) of permanent (Y) moet worden opgeslagen. 1 (Y/N) CARD.BRAND Merk van de betaalmethode 25 CARD.CARDHOLDERNAME Naam van kaarthouder 50 Kaart met X'en ter vervanging van gevoelige gegevens. CARD.CARDNUMBER Voorbeeld: XXXXXXXXXXXX1111 Opmerking: Bij een fout wordt ook de kaart gemaskeerd. 35 CARD.CVC Kaartverificatiecode (Card Verification Code) voor creditcards, met X'en ter vervanging van gevoelige gegevens. Voorbeeld: XXX 6 CARD.EXPIRYDATE Vervaldatum, bv (februari 2020) 4 PARAMPLUS Pass-Through-veld: gegevens opgegeven in de input / SHASIGN SHA-handtekening voor output 128 De geselecteerde parameters worden toegevoegd aan de in uw verzoek gedefinieerde retour-url (PARAMETERS.ACCEPTURL of PARAMETERS.EXCEPTIONURL) in verband met de feedback over de bewerking. 3.4 SHA-handtekening voor output Ons systeem stuurt, op dezelfde wijze als bij e-commerce-transacties, een SHA-OUT-handtekening terug voor de volgende parameters: ALIAS.ALIASID ALIAS.NCERROR ALIAS.NCERRORCARDNO Page 7 of 10-16/09/2016

9 ALIAS.NCERRORCN ALIAS.NCERRORCVC ALIAS.NCERRORED ALIAS.ORDERID ALIAS.STATUS ALIAS.STOREPERMANENTLY CARD.BIC CARD.BIN CARD.BRAND CARD.CARDHOLDERNAME CARD.CARDNUMBER CARD.CVC CARD.EXPIRYDATE Page 8 of 10-16/09/2016

10 4. Stap 2: Integratie met DirectLink Met de alias die u met behulp van de FlexCheckout hebt gegenereerd, kunt u vervolgens dankzij onze standaardtoepassing van DirectLink een DirectLink-transactie indienen. Voor meer informatie, ga naar DirectLink. Dit mechanisme is ook compatibel met DirectLink 3-D. Voor meer informatie over het gebruik van aliassen, ga naar Alias Manager. Page 9 of 10-16/09/2016

11 5. Gebruik met Alias Manager Bij gebruik van de Alias Manager-optie kunt u op de FlexCheckout een selectievakje weergeven, zodat de klant kan bepalen of hij al dan niet permanent zijn financiële gegevens wil opslaan. Daartoe moet u op de configuratiepagina van Alias Manager in uw Ogone account een instelling inschakelen voor weergave van het selectievakje (de standaardwaarde is "Nee"). > We adviseren u deze instelling in te schakelen bij gebruik van one-page-checkout. Ook kunt u, als u een afrekenproces in meerdere stappen hebt geïntegreerd, gebruikmaken van de parameter "StorePermanently" in uw integratie, zodat u zelf kunt bepalen wanneer het selectievakje moet worden weergegeven. Page 10 of 10-16/09/2016