Integreren met KBC/CBC-Paypage e-commerce

Transcriptie

1

2 Inhoudsopgave 1. Inleiding 2. Technische instellingen 3. Verkoopproces 4. Link uw website met de betaalpagina 4.1 Waar te configureren? 4.2 Formulierparameters 4.3 Actie formulier 5. Beveiliging: Controle voor de betaling 5.1 SHA-IN-versleuteling De string aanmaken 5.2 Referrer 6. Look en feel van de betaalpagina 6.1 Sjabloon gehost door KBC/CBC-Paypage (Statische sjabloon) Verborgen velden Betaalzone Style sheets 6.2 Dynamische template Verborgen velden Payment zone (betaalzone) Dynamisch gedrag Style sheets Prestaties Page 1 of 48-21/06/2016

3 6.3 Mobiele sjabloon Opmaakparameters Sjabloon Opmaakmodellen (css) Voorbeeldpagina's 6.4 Template File Manager (Sjabloonbestandsbeheer) Sjabloonbestanden uploaden Geüploade bestanden controleren en beheren Integratie 6.5 Template security control (Veiligheidscontrole op template) 6.6 Hangslot beveiligde omgeving 6.7 Betaalpagina in iframe 7. Transactiefeedback 7.1 Standaardreactie 7.2 Redirectie afhankelijk van het betaalresultaat 7.3 Redirectie met database-update SHA-OUT 7.4 Server-to-server feedback Post-payment URL's Timing van het request/verzoek Antwoord aan de klant HTTP request voor statusveranderingen 7.5 Feedback parameters Dynamische feedbackparameters Variabele feedbackparameters 7.6 Herinitialisatie feedback 7.7 Bevestigingsmails Page 2 of 48-21/06/2016

4 s naar de handelaar s naar de klant 8. Betaallink via 9. Opties voor betaalmethoden 9.1 Keuze van de betaalmethode aan de kant van de handelaar Een specifieke betaalmethode weergeven Toestaan dat de klant een andere betaalmethode kiest: BACKURL 9.2 Een specifieke lijst met betaalmethoden weergeven 9.3 Specifieke betaalmethoden uitsluiten 9.4 Layout van de betaalmethoden 9.5 Venster voor 3-D Secure 9.6 Split credit/debit cards 10. Andere optionele velden 10.1 Operation 10.2 Gebruikersveld (USERID) Page 3 of 48-21/06/2016

5 1. Inleiding Op de volgende pagina's leggen we uit hoe uw online shop te integreren met onze beveiligde online betaalpagina. KBC/CBC-Paypage e-commerce laat u toe om: te integreren met betaalpagina's op het hoogbeveiligde en gemonitorde KBC/CBC-Paypage-platform; de betaalpagina's uit te rusten met dezelfde layout als die van uw eigen website; te werken zonder certificaten of de verantwoordelijkheid te hebben over gevoelige data. Page 4 of 48-21/06/2016

6 2. Technische instellingen In uw KBC/CBC-Paypage account vindt u de Technische instellingen-pagina via "Configuratie" in the hoofdmenu. Per instelling vindt u een "i"-icoontje waarmee u meer info krijgt. Page 5 of 48-21/06/2016

7 3. Verkoopproces De volgende screenshots vertegenwoordigen een verkoopsproces na een basiskoppeling van uw website met ons systeem. Op uw website ziet de klant een samenvattingspagina met de details van zijn bestelling. Hij wordt verzocht deze informatie te bevestigen alvorens naar de beveiligde betaalpagina te gaan. De bevestigingstoets is eigenlijk het zichtbare deel van een HTML form dat verborgen velden met de betaalgegevens bevat en een action die de klant automatisch naar een beveiligde betaalpagina op onze server leidt. De verborgen velden worden in Link uw website met de betaalpagina beschreven. Op onze beveiligde betaalpagina kan de klant kiezen tussen een van de betaalmethoden, die door u geselecteerd werden. Indien de betaling via creditcard gebeurt, zal de klant zijn kaartgegevens moeten invoeren. De klant kan het betalingsverzoek bevestigen of annuleren. Page 6 of 48-21/06/2016

8 Na het betalingsverzoek aan de desbetreffende financiële instelling, wordt aan de klant een pagina getoond met het resultaat van zijn betaling. Indien de betaling geweigerd wordt, wordt er aan de klant een foutmelding gegeven en de mogelijkheid om de betaling opnieuw te proberen. Hij kan een andere betaalmethode kiezen of de gegevens die hij ingevoerd heeft veranderen. Er kan ook een specifieke pagina op uw website aan de klant worden weergegeven, afhankelijk van het resultaat van de transactie. Zie Redirectie afhankelijk van het betaalresultaat voor meer informatie. Page 7 of 48-21/06/2016

9 4. Link uw website met de betaalpagina 4.1 Waar te configureren? De link tussen uw website en onze e-commerce-betaalpagina moet tot stand gebracht worden op de laatste pagina van het winkelmandje van uw website, anders gesteld: de laatste pagina van uw website die aan de klant weergegeven wordt. Een formulier met verborgen html-velden die de bestelgegevens bevat moet geïntegreerd worden in die laatste pagina. Onderstaande codes moeten in de laatste pagina van uw winkelmandje worden geplakt: <form method="post" action=" / orderstandard_utf8.asp" id=form1 name=form1>  <input type="hidden" name="pspid" value=""> <input type="hidden" name="orderid" value=""> <input type="hidden" name="amount" value=""> <input type="hidden" name="currency" value=""> <input type="hidden" name="language" value=""> <input type="hidden" name="cn" value=""> <input type="hidden" name=" " value=""> <input type="hidden" name="ownerzip" value=""> <input type="hidden" name="owneraddress" value=""> <input type="hidden" name="ownercty" value=""> <input type="hidden" name="ownertown" value=""> <input type="hidden" name="ownertelno" value="">  <input type="hidden" name="shasign" value="">  <input type="hidden" name="title" value=""> <input type="hidden" name="bgcolor" value=""> <input type="hidden" name="txtcolor" value=""> <input type="hidden" name="tblbgcolor" value=""> <input type="hidden" name="tbltxtcolor" value=""> <input type="hidden" name="buttonbgcolor" value=""> <input type="hidden" name="buttontxtcolor" value=""> <input type="hidden" name="logo" value=""> <input type="hidden" name="fonttype" value="">  <input type="hidden" name="accepturl" value=""> <input type="hidden" name="declineurl" value=""> <input type="hidden" name="exceptionurl" value=""> <input type="hidden" name="cancelurl" value=""> <input type="submit" value="" id=submit2 name=submit2> </form> 4.2 Formulierparameters Page 8 of 48-21/06/2016

10 Naast de verplichte parameters PSPID, ORDERID, AMOUNT, CURRENCY en LANGUAGE, raden wij u ten stelligste aan om ons ook de naam van de klant, van de klant, adres, stad, postcode, land en telefoonnummer door te sturen, aangezien deze nuttig zijn in fraudebestrijding. Onderstaande is een overzicht van de verborgen velden die gebruikt worden om de algemene parameters naar ons systeem te zenden (de andere velden worden in de volgende hoofdstukken beschreven): Veld Omschrijving PSPID Uw zelf gekozen gebruikersnaam in ons systeem. ORDERID Uw bestelnummer (referentie van de merchant). Het systeem controleert of een betaling niet tweemaal voor dezelfde bestelling werd uitgevoerd. De ORDERID moet dynamisch worden toegewezen. AMOUNT Het te betalen bedrag (VERMENIGVULDIGD MET 100, aangezien de waarde geen decimalen of andere scheidingstekens mag bevatten). Het bedrag moet dynamisch worden toegewezen. CURRENCY Valuta van de bestelling in ISO-alfacode. Bijvoorbeeld: EUR, USD, GBP, LANGUAGE Taal van de klant. Bijvoorbeeld: en_us, nl_nl, fr_fr, Naam van de klant. CN Zal reeds ingevuld worden (maar kan nog aangepast worden) in het veld Naam kaarthouder (of Eigenaar van de rekening ) op de beveiligde betaalpagina. Het adres van de klant. OWNERADDRESS Straatnaam en huisnummer van de klant. OWNERZIP De postcode van de klant. OWNERTOWN Woonplaats (stadsnaam) van de klant. OWNERCTY Land van de klant. OWNERTELNO Telefoonnummer van de klant. 4.3 Actie formulier <form method="post" action=" / orderstandard_utf8.asp " id=form1 name=form1> De actie van het formulier zal de betaalpagina van ons e-commerce-systeem zijn. In de TEST omgeving is de URL: / orderstandard_utf8.asp Page 9 of 48-21/06/2016

11 In de PRODUCTIE omgeving is de URL: / orderstandard_utf8.asp Overschakeling "test" naar "prod" Wanneer u overschakelt naar uw productieaccount moet u in de URL het woord test door prod vervangen.. Indien u dit vergeet wanneer u start met de echte bestellingen, dan worden uw transacties verzonden naar de testomgeving en dus niet naar de financiële instellingen. Page 10 of 48-21/06/2016

12 5. Beveiliging: Controle voor de betaling 5.1 SHA-IN-versleuteling Om de naar ons systeem gestuurde data te controleren (in het geval van e-commerce de verborgen velden naar de betaalpagina), vereist KBC/CBC-Paypage de veilige datacontrolemethode SHA. Voor elke bestelling genereert uw server een unieke tekenstring (=digest) die gehasht wordt volgens het SHA-algoritme van uw keuze: SHA-1, SHA-256 of SHA-512. Eenzelfde berekening kan worden uitgevoerd na de transactie, om de met de redirectie-url's teruggestuurde parameters te controleren. Dit heet de SHA-OUT De string aanmaken De string is opgebouwd uit de aaneenschakeling van de waarden van de velden die met de order zijn verzonden (in alfabetische volgorde, met het formaat PARAMETER=waarde ), telkens gevolgd door een "passphrase" (wachtwoordzin). Deze passphrase is gedefinieerd in de "Technische instellingen", onder het tabblad "Verificatie data en herkomst", in het onderdeel "Verificatie voor e-commerce". De volledige lijst met parameters voor de SHA Digest kunt u hier downloaden. Deze waarden zijn hoofdlettergevoelig wanneer deze uit de string worden opgebouwd voorafgaand aan de hash! Belangrijk Alle verzonden parameters die verstuurd worden (en die voorkomen in de Lijst met parameters die in de SHA-IN moeten worden opgenomen) moeten in de string aanwezig zijn; Alle parameternamen moeten in HOOFDLETTERS staan Parameters moeten alfabetisch gesorteerd zijn Parameters zonder waarden mogen NIET in de string voorkomen Merk op dat sommige sorteeralgoritmes speciale tekens voor het begin van het alfabet plaatsen, anderen zetten deze aan het eind. In geval van twijfel, hanteer de volgorde zoals omschreven in de SHA-lijst. Indien u kiest om uw test-account over te zetten naar productie via de link in uw account-menu, wordt een willekeurige SHA-IN handtekening automatisch geconfigureerd in uw productie-account. Voor extra veiligheid vragen we u om verschillende SHA pass phrases te gebruiken in TEST en PROD. Indien ze identiek zijn, zal ons systeem de TEST pass phrase automatisch aanpassen (u wordt natuurlijk gewaarschuwd). Wanneer u de met het SHA-algoritme opgebouwde string hasht, zal er een hexadecimale tekenreeks worden aangemaakt. De lengte van de SHA-tekenreeks is 40 tekens voor SHA-1, 64 voor SHA-256 en 128 voor SHA-512. Dit resultaat moet naar ons systeem worden gezonden in uw orderaanvraag, via het veld SHASIGN. Ons systeem stelt de SHA-string opnieuw samen, gebaseerd op de ontvangen parameters en vergelijkt de tekenreeks van de Merchant met onze gegenereerde tekenreeks. Als het resultaat niet gelijk is, zal de order worden geweigerd. Deze controle verzekert nauwkeurigheid en integriteit van de ordergegevens. U kunt uw SHASIGN hier testen. Voorbeeld van een SHA-1-IN versleuteling (enkel basis parameters) Parameters (in alfabetische volgorde): AMOUNT=1500 (15.00 x100) CURRENCY=EUR LANGUAGE=en_US ORDERID=1234 PSPID=MyPSPID Page 11 of 48-21/06/2016

13 SHA pass phrase (In Technische instellingen/informatie) Mysecretsig1875!? Te hashen string: AMOUNT=1500Mysecretsig1875!?CURRENCY=EURMysecretsig1875!?LANGUAGE=en_USMysecretsig1875!? ORDERID=1234Mysecretsig1875!?PSPID=MyPSPIDMysecretsig1875!? Resultaat (SHA-1): F4CC376CD7A834D997B91598FA747825A238BE0A Indien de verzonden SHASIGN (verborgen HTML veld) van de transactie niet overeenstemt met de SHASIGN die door ons gemaakt is met de details van de bestelling en de extra string (wachtwoord/wachtzin) die in het "SHA-IN Versleuteling"-veld in de "Verificatie voor e-commerce"-sectie in de "Data en herkomst verificatie" tab van de Technische instellingen-pagina ingevoerd werd, zult u unknown order/1/s" als foutmelding krijgen. Indien er niets in het SHASIGN -veld (verborgen HTML veld) verzonden wordt, hoewel er een extra string (wachtwoord/wachtzin) werd ingegeven in het "SHA-IN Versleuteling" veld in de "Verificatie voor $ecommerce" sectie in de "Data en herkomst verificatie" tab van de Technische instellingen-pagina waarmee u aangeeft dat u een SHA versleuteling bij elke transactie wenst te gebruiken- zal u de foutmelding unknown order/0/s" krijgen. Deze foutmeldingen vindt u in uw account in de Error logs. Meer uitleg vindt u in Mogelijke foutmeldingen. Het volgende verborgen veld wordt gebruikt om de SHA handtekening naar ons systeem te zenden: Veld Omschrijving SHASIGN Unieke tekenreeks om de bestelgegevens te valideren. Een string gehashed met het SHA-1 algoritme is altijd 40 tekens lang. 5.2 Referrer Naast de SHA-controle, kunt u ook de zogenaamde Referrer (herkomst)-controle instellen. Met deze instelling controleert ons systeem de herkomst van een transactieverzoek, d.i. de URL van waar het verzoek komt. Op die manier kunnen ongeautoriseerde URL's (die dus niet geconfigureerd zijn in uw account) de betaalpagina niet aanroepen. U dient de URL('s) van de pagina('s), die het bestelformulier met de verborgen velden bevat, in te voeren in uw account via "Technische instellingen" > tabblad "Verificatie data en herkomst" > sectie "Verificatie voor e-commerce". Belangrijk De URL('s) moet(en) altijd beginnen met of U kunt de volledige URL of gewoon de domeinnaam invoeren; als u de domeinnaam invoert, worden alle submappen en pagina's van dat domein aanvaard. Als u verschillende domeinen hebt, kunt u meerdere URL's invoeren, bijvoorbeeld // De URL's moeten worden gescheiden door een puntkomma, zonder spaties vóór of na de puntkomma. Als u vanuit onze testpagina een testtransactie uitvoert, vergeet dan niet om de URL van onze site in te voeren als een verwijzer, anders krijgt u een foutbericht. Hoewel ons systeem aan de hand van de referrer de oorsprong van een bestelling kan identificeren, garandeert dit niet de integriteit van de gegevens. Page 12 of 48-21/06/2016

14 Mogelijke gerelateerde foutmeldingen zijn "unknown order/1/r" en "unknown order/0/r". Ga naar Mogelijke foutmeldingen voor meer informatie over deze en andere foutmeldingen. Page 13 of 48-21/06/2016

15 6. Look en feel van de betaalpagina De gehoste betaalpagina bevat twee soorten informatie: statische informatie (bijvoorbeeld uw logo) betaalgegevens (bijvoorbeeld referentie van de bestelling, velden waar de klant zijn kaartgegevens invult, etc.). De statische informatie is afkomstig van de gebruikelijke lay-out van ons systeem of een bepaalde sjabloonpagina van de handelaar. Ons systeem voegt de betaalgegevens dynamisch toe voor elke transactie. De handelaar kan de weergave van deze betaalgegevens echter aanpassen met behulp van html-stijlen. Er zijn twee manieren om het ontwerp van de betaalprocespagina aan te passen teneinde de look en feel van uw site tijdens het betaalproces te behouden: met behulp van een statische-sjabloonpagina of een dynamische-sjabloonpagina: Met een statische-sjabloonpagina worden uw sjabloonbestanden veilig gehost in onze PCI-DSS-gecertificeerde omgeving. Wilt u uw sjabloonpagina op uw eigen server hosten, voor meer flexibiliteit en 'dynamisch' gedrag, dan moet u een dynamischesjabloonpagina gebruiken. 6.1 Sjabloon gehost door KBC/CBC-Paypage (Statische sjabloon) Met behulp van een sjabloon op de gehoste betaalpagina hebt u veel meer mogelijkheden om de vomgeving van de pagina aan te passen dan wanneer u alleen uw logo, titel en kleurvelden gebruikt. U kunt uw sjabloonpagina helemaal zelf ontwerpen, waarbij u op die pagina slechts één gebied overlaat dat door ons systeem wordt ingevuld. Uw sjabloonpagina en -bestanden worden gehost in onze veilige omgeving, die we de 'statische sjabloon' noemen Verborgen velden Het volgende verborgen veld wordt gebruikt om de bestandsnaam van uw templatepagina door te sturen: <input type="hidden" name="tp" value=""> Veld Omschrijving TP Bestandsnaam van de sjabloon gehost door KBC/CBC-Paypage. Voorbeeld: <input type="hidden" name="tp" value="mytemplatefile.html"> Betaalzone U kunt de dynamische-templatepagina geheel naar eigen wens ontwerpen. De enige vereiste is dat ze de tekenreeks "$$$PAYMENT ZONE$$$" (betaalzone) bevat, die aangeeft waar onze e-commerce-module haar velden dynamisch kan toevoegen. Bijgevolg moet ze ten minste het volgende bevatten: <html> $$$PAYMENT ZONE$$$ </html> Belangrijk Page 14 of 48-21/06/2016

16 Gebruik geen BASE-tags, frames of FORM-tags om de tekenreeks $$$PAYMENT ZONE$$$ af te bakenen Style sheets Door style sheets (opmaakmodellen) aan uw templatepagina toe te voegen kunt u de vormgeving en uitstraling van uw betaalpagina's personaliseren. We hebben een klasse gedefinieerd voor de diverse typen tabellen en cellen binnen onze tabellen, evenals een klasse voor verzendknoppen. U moet het volgende blok code tussen de tags <head></head> toevoegen en de eigenschappen van deze klassen wijzigen zodat ze passen bij de vormgeving en uitstraling van uw site (volgens het voorbeeld van de genoemde templatepagina): <style type="text/css">  </style> Wanneer u uw eigen lay-outinstructies invoert, moet u zich houden aan de syntaxis van Cascading Style Sheets. Wij raden u ten zeerste aan om dit in verschillende browsers te testen, omdat er enorme verschillen kunnen zijn in de manier waarop deze omgaan met style sheets. Page 15 of 48-21/06/2016

17 6.2 Dynamische template Met de dynamische sjabloonpagina hebt u meer mogelijkheden om de vormgeving van de betaalpagina aan te passen dan met de statische sjabloon. Wanneer u een dynamische-sjabloonpagina gebruikt, ontwerpt u volledig uw eigen sjabloonpagina, waarbij u op die pagina slechts één gebied overlaat dat door ons systeem wordt ingevuld. U dient ons de URL van uw sjabloonpagina te sturen in de verborgen velden voor elke transactie. Houd er rekening mee dat het gebruik van een dynamische-sjabloonpagina een extra verzoek van ons systeem inhoudt om uw sjabloonpagina op te zoeken. Dit betekent dat het betaalproces langer duurt. Belangrijk Page 16 of 48-21/06/2016

18 Om aan de nieuwste PCI-DSS te voldoen bent u verplicht uw sjabloon (en de bijbehorende bestanden) te hosten in een omgeving met de hoogste PCI-certificering Verborgen velden Het volgende verborgen veld wordt gebruikt om de URL van uw templatepagina door te sturen: <input type="hidden" name="tp" value=""> Veld Omschrijving TP URL van de dynamische-templatepagina van de handelaar (de pagina moet aan de kant van de handelaar worden gehost). De URL moet absoluut zijn (het volledige pad bevatten), d.w.z. mag niet relatief zijn. Specificeer geen poorten in uw URL. Wij aanvaarden alleen poort 443 en poort 80. Elke in de templatepagina opgenomen component moet ook een absolute URL hebben Payment zone (betaalzone) U kunt de dynamische-templatepagina geheel naar eigen wens ontwerpen. De enige vereiste is dat ze de tekenreeks "$$$PAYMENT ZONE$$$" (betaalzone) bevat, die aangeeft waar onze e-commerce-module haar velden dynamisch kan toevoegen. Bijgevolg moet ze ten minste het volgende bevatten: <html> $$$PAYMENT ZONE$$$ </html> Belangrijk Gebruik geen BASE-tags, frames of FORM-tags om de tekenreeks $$$PAYMENT ZONE$$$ af te bakenen. Een voorbeeld van een dynamische-templatepagina vindt u op het volgende adres: Dynamisch gedrag Dezelfde templatepagina kan worden gebruikt voor alle bestellingen, of de templatepagina kan door uw toepassing dynamisch worden gegenereerd volgens de parameters van de bestelling. Om de templatepagina dynamisch te genereren, kan de handelaar voor de bestelling een specifieke pagina maken waarvan de URL in de verborgen velden wordt doorgestuurd, of kan hij een vaste URL gebruiken maar een resultaat terugsturen dat van het bestelnummer is afgeleid. Om dit mogelijk te maken, voegt ons systeem de belangrijkste betaalgegevens waaronder het referentienummer van uw bestelling (cf. verwerking na betaling) toe wanneer het de templatepagina ophaalt: HTTP request = url_page_template?orderid=...&amount=...&currency= Style sheets Door style sheets (opmaakmodellen) aan uw templatepagina toe te voegen kunt u de vormgeving en uitstraling van uw betaalpagina's personaliseren. We hebben een klasse gedefinieerd voor de diverse typen tabellen en cellen binnen onze tabellen, evenals een klasse voor Page 17 of 48-21/06/2016

19 verzendknoppen. U moet het volgende blok code tussen de tags <head></head> toevoegen en de eigenschappen van deze klassen wijzigen zodat ze passen bij de vormgeving en uitstraling van uw site (volgens het voorbeeld van de genoemde templatepagina): <style type="text/css">  </style> Wanneer u uw eigen lay-outinstructies invoert, moet u zich houden aan de syntaxis van Cascading Style Sheets. Wij raden u ten zeerste aan om dit in verschillende browsers te testen, omdat er enorme verschillen kunnen zijn in de manier waarop deze omgaan met style sheets. Page 18 of 48-21/06/2016

20 6.2.5 Prestaties Ons systeem is geconfigureerd met een time-out van 5 seconden voor het ophalen van de dynamische-templatepagina door het verzoek. Als een time-out optreedt, zal ons systeem in plaats daarvan uw statische template gebruiken. Als er geen statische template is geconfigureerd, zal ons systeem in laatste instantie de statische KBC/CBC-Paypage-template gebruiken. Dit veld HTTPTimeOut heeft een impact op zowel dynamische-templateverzoeken als feedbackverzoeken na betaling (zie Direct feedback-verzoeken (na betaling)). Dit betekent dat als u zou beslissen om de time-out te wijzigen in bijvoorbeeld 15 seconden, de time-out voor het feedbackverzoek ook 15 seconden wordt. Voor elke bestelling voert ons systeem een verzoek uit om uw dynamische-templatepagina op te halen. Als u zeer veel transacties hebt of als u een grote templatepagina hebt (bijvoorbeeld omdat uw dynamische-templatepagina een groot aantal afbeeldingen bevat), kunnen deze http-verzoeken lang duren. Neem contact op met ons Sales team voor een oplossing als u zeer veel transacties hebt. 6.3 Mobiele sjabloon U kunt de weergave van de betaalpagina op mobiele apparaten (smartphones, tablets, enz.) optimaliseren met een sjabloonpagina met opmaakmodellen, zoals in de volgende hoofdstukken wordt uitgelegd Opmaakparameters Hieronder staan de velden die kunnen worden aangepast door gegevens in te voeren in een verzoek: <input type="hidden" name="title" value=""> <input type="hidden" name="bgcolor" value=""> <input type="hidden" name="txtcolor" value=""> <input type="hidden" name="tblbgcolor" value=""> <input type="hidden" name="tbltxtcolor" value=""> <input type="hidden" name="buttonbgcolor" value=""> <input type="hidden" name="buttontxtcolor" value=""> <input type="hidden" name="logo" value=""> <input type="hidden" name="fonttype" value=""> Veld Omschrĳving Standaardwaarde TITEL Titel van de pagina Title Page 19 of 48-21/06/2016

21 BGCOLOR Achtergrondkleur white TXTCOLOR Tekstkleur black TBLBGCOLOR Achtergrondkleur voor de rechterkolommen white TBLTXTCOLOR Tekstkleur voor de rechterkolommen black BUTTONBGCOLOR Kleur van knopachtergrond N.v.t. BUTTONTXTCOLOR Kleur van knoptekst black URL/bestandsnaam van het logo dat u op de betaalpagina wilt weergeven LOGO Belangrijk: Vanwege de nieuwe PCI-DSS-norm van januari 2015 moeten uw logo's en andere afbeeldingen op de betaalpagina worden gehost op KBC/CBC-Paypage. - LETTERTYPE Lettertypegroep Verdana Sjabloon Het volgende verborgen veld wordt gebruikt om de URL van uw sjabloonpagina door te sturen: <input type="hidden" name="tp" value=""> Veld Omschrĳving URL van de dynamische-sjabloonpagina. De URL moet absoluut zijn (het volledige pad bevatten), d.w.z. mag niet relatief zijn. Elke in de sjabloonpagina opgenomen component moet ook een absolute URL hebben. TP Belangrijk: Om aan de nieuwste PCI-DSS (2015) te voldoen, bent u verplicht uw sjabloonitems voor de betaalpagina te hosten in een omgeving met de hoogste PCI-certificering. Daarom raden wij u aan uw bestanden te hosten bij KBC/CBC-Paypage. Betaalzone U kunt de sjabloonpagina geheel naar eigen wens ontwerpen. De enige vereiste is dat ze de tekenreeks "$$$PAYMENT ZONE$$$" bevat, die aangeeft waar onze e-commerce module haar velden dynamisch kan toevoegen. Bijgevolg moet ze ten minste het volgende bevatten: <html> $$$PAYMENT ZONE$$$ </html> Bekijk de Voorbeeldsjablonen om inspiratie op te doen met de door ons gemaakte sjablonen, of maak gewoon uw eigen sjabloon op basis van die van ons Opmaakmodellen (css) Page 20 of 48-21/06/2016

22 Om de CSS inzichtelijk te maken, zodat deze eenvoudiger kan worden beheerd, hebben we de sjabloon-css verdeeld in vier hoofdonderdelen: Header Betaalgegevens Voettekst Sectie betaalstatus Opmerking: Hoewel de onderstaande voorbeeldafbeeldingen laten zien op welke elementen de css van invloed is, kan de gebruikte opmaak (kleuren, afbeeldingen, enz.) afwijken van wat in de bijbehorende voorbeeldcodes wordt beschreven. Header Met deze opmaak kunt u de header van de betaalpagina wijzigen zoals hieronder getoond: Element(s) - Lock Part.securedBG { background: #797979; }.secured { padding: 8px 20px 0px 40px; color: #ffffff; width: 235px; margin: 0 auto; background: url("lock.png") 5px no-repeat #797979; height: 30px; } - Order Summary table.ncoltable1 { width: 100%; Page 21 of 48-21/06/2016

23 margin: 0 auto; min-width: 300px!important; } td.ncoltxtl { font-family: open-sans,verdana,sans-serif; font-size: 14px; background-color:#ffffff; text-align : left!important; font-weight : bold!important; vertical-align:bottom; } td.ncoltxtr { text-align: left; font-weight: normal; font-family: open-sans,verdana,sans-serif; font-size: 14px; background-color:#ffffff; } Betaalgegevens Met deze opmaak kunt u de sectie Betaalgegevens wijzigen zoals hieronder getoond: Page 22 of 48-21/06/2016

24 td.ncolinput { text-align: left; font-weight: normal; font-size: 14px; font-family: open-sans,verdana,sans-serif; display: block; box-shadow: none!important; } input.ncol { background-color: #ffffff; height: 40px; font-size: 14px; text-align: center; padding: 0px; font-family: open-sans,verdana,sans-serif; margin: 0 35px 20px; border-bottom: 1px solid #999999; Page 23 of 48-21/06/2016

25 border-radius: 0px; -webkit-appearance: none!important; -webkit-border-radius: 0!important; } td.ncoltxtl2 { text-align: left; font-family: open-sans,verdana,sans-serif; white-space: nowrap; display: block; font-size: 14px; background-color:#ffffff; } Voettekst Met deze opmaak kunt u de voettekst van de betaalpagina instellen: Element(s) td.ncollogoc { text-align: center; font-weight: normal; font-size: 14px; padding: 2px; vertical-align: top!important; } td.ncollogoc IMG { width: 90px; height: 55px; margin-right: 4px; } Page 24 of 48-21/06/2016

26 .ncollogoc td.ncol { width: auto; padding-right: 10px; padding-left: 10px; cursor:pointer; }.ncollogoc input.ncol { margin-top:10px!important; -webkit-appearance: none!important; -webkit-border-radius: 0!important; } Sectie betaalstatus Via deze sectie kunt u de uitstraling van de betaalstatuspagina aanpassen zoals hieronder getoond: Element(s) td.ncoltxtc { background-color:#ffffff; color:#999999; padding: 0px; text-align: left; font-weight: normal; font-size: 14px; border-top: 0px solid #ffffff; font-family: open-sans,verdana,sans-serif; } td.ncoltxtc h3 { text-align: center; font-weight: normal!important; padding: 5px; font-family: open-sans,verdana,sans-serif; } td.ncoltxtmessage { background-color: #ffffff; color: #999999; Page 25 of 48-21/06/2016

27 text-align: left; font-weight: normal; } De pagina zou er nu als volgt uitzien: Page 26 of 48-21/06/2016

28 6.3.4 Voorbeeldpagina's Page 27 of 48-21/06/2016

29 Om u te helpen, hebben we zelf twee pagina's gemaakt. De eerste is een merkversie die u als voorbeeld kunt gebruiken: Ook kunt u de volgende 'gestripte' versie gebruiken als basis voor uw sjabloon: Dezelfde twee sjablonen met aanvullende bestanden (lettertypen, afbeeldingen) kunnen hier worden gedownload als zipbestand. 6.4 Template File Manager (Sjabloonbestandsbeheer) Met Template File Manager (Sjabloonbestandsbeheer) kunt u eenvoudig uw sjablonen/templates en de bijbehorende bestanden beheren. Als u File Manager wilt gebruiken, meldt u zich aan bij uw KBC/CBC-Paypage account en selecteert u 'Configuratie' > 'Sjabloon' > 'File Manager'. Belangrijk Het is niet mogelijk om bestanden die eerder zijn geüpload door KBC/CBC-Paypage tegelijkertijd te gebruiken met bestanden die zijn geüpload met File Manager in uw integratie. Als u bestanden hebt die in het verleden zijn geüpload door KBC/CBC-Paypage moet u die bestanden zelf opnieuw uploaden met File Manager Sjabloonbestanden uploaden Klik onder 'Sjabloonbestanden uploaden' (Upload Template Files) op 'Bestanden...' (Files) om te zoeken naar de bestanden die u wilt uploaden. U kunt Javascripts, html, css en afbeeldingen (.css,.jpg,.jpeg,.gif,.png,.html,.js) uploaden (maximaal 7 MB per bestand en 10 MB in totaal). Selecteer de bestanden en bevestig uw keuze Geüploade bestanden controleren en beheren Als de bestanden zijn geüpload, worden ze op dezelfde pagina weergegeven in het gedeelte 'Geüploade bestanden'. De bestanden hebben eerst de status 'Bezig met valideren'. In deze fase worden een aantal noodzakelijke veiligheids-/viruscontroles uitgevoerd. Zodra de bestanden de status 'Gevalideerd' hebben, kunt u ze gebruiken. Klik op de knop 'Refresh' (Vernieuwen) om de huidige status van uw bestanden te controleren; klik op de knop 'Delete' (Verwijderen) om een bestand permanent te verwijderen. Page 28 of 48-21/06/2016

30 Als een bestand de status 'Geweigerd' heeft, is het niet door de veiligheidscontrole gekomen. Er kan dan bijvoorbeeld een virus zijn aangetroffen of de bestandsextensie is onjuist Integratie In uw sjablonen verwijst u naar uw geüploade bestanden met een code die de volgende structuur heeft: "$$$TP RESOURCES URL$$$/[uw bestandsnaam]". Voorbeeld: Om naar uw geüploade sjabloon in uw e-commerce integratie te verwijzen, verzendt u de sjabloonbestandsnaam met de 'TP'-parameter. Voorbeeld: TP=mytemplatefile.html Werkt u met een basisintegratie e-commerce met een logo boven aan de pagina, dan moet u naar het geüploade logo verwijzen door de bestandsnaam samen met de 'LOGO'-parameter te verzenden. Voorbeeld: LOGO=mycompanylogo.png 6.5 Template security control (Veiligheidscontrole op template) Om uw klanten te beschermen tegen frauduleuze activiteiten, zoals manipulatie van gevoelige kaartgegevens (kaartnummer, verificatiecode), werden verschillende veiligheidscontroles voor de handelaarstemplate beschikbaar gesteld. In het deel "Template" op het tabblad "Algemene beveiligingsparameters" van uw "Technische instellingen"-pagina kunnen de volgende instellingen worden geconfigureerd: JavaScript-controle op template activeren U kunt deze functie inschakelen om het gebruik van Javascript op de templatepagina te detecteren. Als Javascript wordt gedetecteerd, Page 29 of 48-21/06/2016

31 wordt de sjabloon geblokkeerd en wordt in plaats daarvan de standaardtemplate gebruikt. Gebruik van statische template toestaan Als u Gebruik van statische template toestaan selecteert, moet u een of meer waarden invoeren in het veld Naam van vertrouwde statische template. Deze waarden worden vervolgens gebruikt als input voor een controle waarbij deze waarden worden vergeleken met de informatie die KBC/CBC-Paypage tijdens het betaalproces heeft ontvangen. Gebruik van dynamische template toestaan (optioneel, afhankelijk van uw abonnement) Als u Gebruik van dynamische template toestaan selecteert, is het verplicht om het veld Naam van vertrouwde websitehost die de dynamische sjabloon host te configureren. Dit veld kan meerdere webhosts (gescheiden door puntkomma's) bevatten, maar ze moeten allemaal de volledige URL (bijvoorbeeld bevatten. De submappen kunnen worden weggelaten. Als de dynamische template is, volstaat het dus om te configureren als vertrouwde webhost. Daarnaast kunt u ook één of meer URL's van volledig vertrouwde dynamische templates (gescheiden door puntkomma's) configureren in het veld URL van vertrouwde dynamische template. Als samen met een transactie een dynamische template wordt doorgestuurd maar dynamische templates niet zijn toegestaan, wordt de template geblokkeerd en gebruikt ons systeem in plaats daarvan de statische template. Als er geen statische template is geconfigureerd of als de statische template ook niet is toegestaan, wordt de standaard KBC/CBC- Paypage-template gebruikt. Als een statische of dynamische standaardtemplate is geconfigureerd in uw account (vooraf aangevraagd bij ons Customer Care team), moet één van de twee opties (Gebruik van statische template toestaan / Gebruik van dynamische template toestaan) worden ingeschakeld. De URL van de template moet worden geconfigureerd als een vertrouwde template. Als de invoervelden Naam van vertrouwde statische template en URL van vertrouwde dynamische template leeg worden gelaten, worden standaard alle sjablonen vertrouwd. Standaard worden JavaScript-controle op template inschakelen en Gebruik van statische template toestaan ingeschakeld. De Naam van vertrouwde statische template wordt vooraf ingesteld op de naam van uw websitehost. 6.6 Hangslot beveiligde omgeving De URL die wordt gebruikt om de klant te verbinden met ons platform maakt gebruik van een beveiligd protocol (https). Alle communicatie tussen ons e-commerce-platform en de klant wordt veilig versleuteld (gecodeerd). Het hangslotpictogram in de browser dat aan de klant aangeeft dat de site beveiligd is wordt mogelijk niet weergegeven als sommige elementen (bijvoorbeeld afbeeldingen) in de sjabloonpagina zich niet op een beveiligde server bevinden of als sommige frames op het scherm pagina's tonen die niet afkomstig zijn van beveiligde sites. Zelfs als de communicatie met betrekking tot de verwerking van de betaling wordt versleuteld, zullen de meeste browsers geen beveiligde verbinding herkennen, tenzij alle elementen op het scherm, met inbegrip van afbeeldingen, geluiden, etc. afkomstig zijn van beveiligde sites. Bij handelaren die geen beveiligde site hebben, moet rekening worden gehouden met de volgende regels: Gebruik geen frames voor de betaalpagina's: u kunt het volledige scherm vernieuwen met een sjabloonpagina die eruit ziet alsof u frames gebruikt, of u kunt toestaan dat de betaling in een nieuw venster wordt verwerkt. Link geen bestanden naar de templatepagina (<link> -tag) die u gebruikt voor de betaalpagina. Gebruik in plaats daarvan de <style> and <script> tags to include styles and scripts into the template page. Bewaar de afbeeldingen in uw template op een beveiligde server (de templatepagina zelf kan op een niet-beveiligde server, de afbeeldingen niet). KBC/CBC-Paypage biedt hosting aan voor o.m. afbeeldingen (log in op uw account om uw "image hosting"-opties te bekijken). Page 30 of 48-21/06/2016

32 6.7 Betaalpagina in iframe Met iframe kunt u een externe webpagina (zoals de betaalpagina) integreren in uw website, met behoud van uw eigen URL in de browser. In de huidige context heeft iframe ook zeer aanzienlijke nadelen: Omdat de URL die van uw website is, kan het een gewone http (in plaats van een https) zijn en is het mogelijk dat het hangslotpictogram niet in de browser wordt weergegeven. Dit kan ertoe leiden dat klanten gaan twijfelen aan de veiligheid van de webwinkel. Sommige betaalmethoden (zoals Giropay, Sofort, Bancontact/Mister Cash, PayPal, etc.) gebruiken omleidingen, wat problemen kan geven met de lay-out en/of navigatie. Daarom raadt KBC/CBC-Paypage het gebruik van iframe af en is het gebruik ervan de verantwoordelijkheid van de handelaar. KBC/CBC- Paypage raadt in plaats daarvan ten zeerste aan om een dynamische template te gebruiken. Als u toch nog iframe wilt integreren, raden wij u ten zeerste het volgende aan: Gebruik iframe alleen op de pagina voor de keuze van de betaalmethode (en daarna) Gebruik indien mogelijk pop-ups voor externe betaalmethoden om de zichtbaarheid van webapplicaties van derden te garanderen. Page 31 of 48-21/06/2016

33 7. Transactiefeedback Nadat een transactie verwerkt is kan er feedback naar u en uw klant gestuurd worden, afhankelijk van het resultaat van de transactie. Hierna beschrijven we wanneer en hoe de transactiefeedback kan gestuurd worden, en wat u langs uw kant dient op te zetten en te configureren om elk feedbackproces mogelijk te maken. Best practice Redirectie met feedbackparameters op de accept-/exception-/cancel-/declineurl (zie Redirectie met database-update) met een uitgestelde post-payment request als backup (zie Server-to-server feedback). In uw KBC/CBC-Paypage account, ga naar "Configuratie" > "Technische instellingen" > "Transactiefeedback". Configureer de instellingen zoals hieronder weergegeven: HTTP redirectie in de browser: ("Ik wil de feedbackparameters van de transacties op de redirectie-url's ontvangen.") Direct HTTP server-to-server request: ("Altijd uitgesteld (niet onmiddellijk na de betaling).") 7.1 Standaardreactie Als u niets heeft ingesteld, geeft ons systeem het volgende standaardbericht weer voor de klant: "Geautoriseerd" of "De transactie is geweigerd". Dit bericht wordt ingevoegd in de templatepagina. Page 32 of 48-21/06/2016

34 Op deze pagina voegen we ook een link naar uw website en/of catalogus toe, waarbij we de in de verborgen velden van het bestelformulier verzonden URL's HOMEURL en CATALOGURL gebruiken. Als de URL's niet zijn opgegeven in de verborgen velden, gebruikt ons systeem de URL's die in de administratieve gegevens van uw KBC/CBC-Paypage-account zijn ingesteld. De volgende verborgen velden worden gebruikt om de URL's door te sturen: <input type="hidden" name="catalogurl" value=""> <input type="hidden" name="homeurl" value=""> Veld Omschrijving CATALOGURL (Absolute) URL van uw catalogus. Wanneer de transactie is verwerkt, wordt uw klant gevraagd om via een knop naar deze URL terug te keren. HOMEURL (Absolute) URL van uw homepage. Wanneer de transactie is verwerkt, wordt uw klant gevraagd om via een knop naar deze URL terug te keren. Wanneer u de waarde 'NONE' verzendt, wordt de knop die terug naar uw site leidt verborgen. 7.2 Redirectie afhankelijk van het betaalresultaat Er zijn vier URL's waar ons systeem de klant naartoe kan sturen na een transactie, afhankelijk van het resultaat. Het betreft hier de "ACCEPTURL", "EXCEPTIONURL", "CANCELURL" en "DECLINEURL". De URL's kunnen geconfigureerd of verstuurd worden als volgt: Configuratie in uw KBC/CBC-Paypage account: In de "Transactiefeedback"-tab van uw "Technische instellingen"-pagina: "HTTP-redirectie in de browser" Page 33 of 48-21/06/2016

35 URL's sturen in de verborgen velden van uw formulier: <input type="hidden" name="accepturl" value=""> <input type="hidden" name="declineurl" value=""> <input type="hidden" name="exceptionurl" value=""> <input type="hidden" name="cancelurl" value=""> Veld ACCEPTURL DECLINEURL EXCEPTIONURL CANCELURL Omschrijving URL van de webpagina die de klant te zien krijgt wanneer de betaling geautoriseerd is (status 5), geaccepteerd (status 9) of in afwachting van aanvaarding (status 51 of 91). URL van de webpagina die de klant te zien krijgt wanneer de acquirer de autorisatie weigert (status 2) na meer dan het maximum aantal toegelaten pogingen. URL van de webpagina die de klant te zien krijgt wanneer het betaalresultaat onzeker is (status 52 of 92). Indien dit veld leeg is zal de klant de accepturl te zien krijgen. URL van de webpagina die de klant te zien krijgt wanneer hij de betaling annuleert (status 1). Indien dit veld leeg is zal de klant de declineurl te zien krijgen. Browserwaarschuwing: van beveiligde naar onbeveiligde omgeving Wanneer een klant vanuit onze beveiligde betaalpagina's naar uw website terugkeert, is het mogelijk dat hij een browserwaarschuwing krijgt om hem te waarschuwen dat hij een niet-beveiligde omgeving betreedt (aangezien hij van een naar een gaat). Wanneer we een omleiding naar uw website detecteren, kunnen we een bericht weergeven om de klant te informeren dat er een risico bestaat en zo onnodige bezorgdheid over een browserwaarschuwing vermijden. U kunt deze optie activeren op het tabblad "Transactiefeedback" in het deel 'HTTP redirectie in de browser" van de "Technische instellingen"-pagina ("Ik wil dat KBC/CBC-Paypage een kort redirectiebericht toont aan de klant voordat deze wordt teruggestuurd naar mijn website") 7.3 Redirectie met database-update U kunt de redirectie op basis van de redirectie-url's gebruiken om automatische backofficetaken, zoals database-updates, te activeren. Wanneer een betaling wordt uitgevoerd, kunnen we de transactieparameters naar uw ACCEPT-, EXCEPTION-, CANCEL- of DECLINEURL verzenden. In uw "Technische instellingen"-pagina, tabblad "Transactiefeedback", in het deel "HTTP-redirectie in de browser" kunt u de volgende optie activeren: "Ik wil de feedbackparameters van de transacties op de redirectie-url's ontvangen." SHA-OUT Het redirectieproces is zichtbaar, omdat dit via de browser van de klant wordt verzonden. Daarom moet u gebruikmaken van een SHA-handtekening om de inhoud van het verzoek te controleren en te voorkomen dat klanten de gegevens in het URL-veld wijzigen. Dit zou frauduleuze updates van de database tot gevolg kunnen hebben. Als u geen SHA-OUT-handtekening configureert, verzenden wij geen parameters naar uw redirectie-url. De SHA-string is opgebouwd uit de aaneenschakeling van de velden en hun waarden die tijdens de order zijn verzonden (in alfabetische volgorde, met het formaat "parameter=waarde", telkens gevolgd door een passphrase). Deze passphrase is gedefinieerd in uw "Technische Page 34 of 48-21/06/2016

36 instellingen"-pagina, in het tabblad "Transactiefeedback", onder "Alle transactiemodi". Raadpleeg de SHA-OUT-parameterlijst voor de volledige lijst met parameters die in een SHA-reeks moeten worden opgenomen. Merk op dat deze parameters allemaal hoofdlettergevoelig zijn. Belangrijk Alle verzonden parameters die doorgestuurd worden (en die in de SHA-OUT-parameterlijst voorkomen), moeten in de string aanwezig zijn. Parameters moeten alfabetisch gesorteerd zijn Parameters zonder waarden mogen NIET in de string voorkomen Hoewel sommige parameters (gedeeltelijk) in kleine letters worden teruggekoppeld door ons systeem, is het voor de SHA-OUT berekening verplicht elke parameter in hoofdletters te zetten. Indien u kiest om uw test-account over te zetten naar productie via de link in uw account-menu, wordt een willekeurige SHA-OUT handtekening automatisch geconfigureerd in uw productie-account. Voor extra veiligheid vragen we u om verschillende SHA passphrases te gebruiken tussen TEST en PROD. Indien deze identiek zijn, zal ons systeem de TEST passphrase automatisch aanpassen (u wordt natuurlijk gewaarschuwd). Op dezelfde manier waarop wij een reeks opnieuw aanmaken om een invoer van een transactie met SHA-IN te valideren, moet u de Hash opnieuw aanmaken met uw SHA-OUT passphrase en de parameters die u van ons systeem heeft ontvangen. Als het resultaat niet gelijk is, kan het zijn dat de parameters van de aanvraag zijn vervalst. Deze controle verzekert nauwkeurigheid en integriteit van de parametergegevens in de aanvraag. Voorbeeld van een basis SHA-1-OUT versleuteling Parameters (in alfabetische volgorde): ACCEPTANCE: 1234 amount: 15 BRAND: VISA CARDNO: XXXXXXXXXXXX1111 currency: EUR NCERROR: 0 orderid: 12 PAYID: PM: CreditCard STATUS: 9 SHA passphrase (in Technische instellingen): Mysecretsig1875!? Te hashen string (met alle parameternamen in hoofdletters): ACCEPTANCE=1234Mysecretsig1875!?AMOUNT=15Mysecretsig1875!?BRAND=VISAMysecretsig1875!? CARDNO=XXXXXXXXXXXX1111Mysecretsig1875!?CURRENCY=EURMysecretsig1875!?NCERROR=0 Mysecretsig1875!?ORDERID=12Mysecretsig1875!?PAYID= Mysecretsig1875!?PM=CreditCard Mysecretsig1875!?STATUS=9Mysecretsig1875!? Resulterende tekenreeks (SHA-1): F93A9AB8E474EA78D899AFDBB Server-to-server feedback Page 35 of 48-21/06/2016

37 Na de betaling kan ons systeem een http-verzoek sturen naar een door u opgegeven URL om de transactiegegevens door te sturen. Via dit proces, ook "post-sale" genoemd, kunt u uw database bijwerken met de orderstatus, enz. en kunt u een 'einde van bestelling'-proces starten (als dat nog niet is gebeurd na de redirectie). Het is ook een alternatieve manier om een persoonlijk antwoord voor de klant te genereren in het geval van specifieke behoeften (als dat nog niet is gebeurd via de redirectie). De feedbackparameters zijn dezelfde als die voor de redirectie Post-payment URL's Om uw backofficetaken te automatiseren, kunt u de URL's van twee uitvoerbare pagina's op uw site opgeven in uw "Technische instellingen" > "Transactiefeedback", in het deel "Direct HTTP server-to-server request" (URL-velden): Het eerste veld kan de URL bevatten waarnaar de request-parameters worden verzonden als de betaling de status "aanvaard", "in behandeling" of "onzeker" heeft. Het tweede veld kan de URL bevatten waarnaar de request-parameters worden verzonden wanneer de transactie door de klant is geannuleerd of te vaak door de acquirer is geweigerd (dat wil zeggen meer dan het maximaal toegestane aantal betaalpogingen zoals ingesteld op het tabblad "Algemene transactieparameters" in het deel "Betaalpogingen" van uw "Technische instellingen"-pagina) Deze twee URL's kunnen verschillen, maar ze kunnen ook identiek zijn. U kunt ook een URL invoeren voor het eerste geval, maar niet voor het tweede. Specificeer geen poorten in uw URL. Wij aanvaarden alleen poort 443 en poort 80. Variabele post-payment URLs voor meerdere shops Als u op de pagina "Technische instellingen" van uw account een pagina na betaling hebt geconfigureerd maar u verschillende winkels hebt die elk verbonden zijn met een specifieke map voor het ontvangen van feedback na betaling, kan een deel van uw URL na betaling variabel zijn. Dit variabele gedeelte kan ook worden gebruikt om bijvoorbeeld het feedbackverzoek 'aan te passen' om er informatie over de sessie in op te nemen, waarbij deze informatie wordt doorgegeven als onderdeel van de URL en niet als een extra parameter. Dit is het geval voor Intershop-platforms of Servlet-systemen. Het volgende verborgen veld moet worden gebruikt: <input type="hidden" name="paramvar" value=""> Voorbeeld: Post-payment URL in uw pagina "Technische instellingen": Het extra verborgen veld dat u verzendt: <input type="hidden" name="paramvar" value="shop1"> Resulterend in de volgende URL na betaling voor de transactie: Belangrijk: Gebruik geen speciale tekens in het veld PARAMVAR omdat ze in de URL worden gecodeerd, waardoor mogelijk ongeldige links worden gecreëerd Timing van het request/verzoek In uw "Technische instellingen"-pagina, tabblad "Transactiefeedback", in het deel "Direct HTTP server-to-server request" kunt u de timing van het feedbackverzoek kiezen: Page 36 of 48-21/06/2016

38 Geen request In dit geval zal ons systeem geen feedbackverzoek verzenden. Met deze optie kunt u uw URL's na betaling uitschakelen in geval van onderhoud of problemen op uw server. Altijd uitgesteld (niet onmiddellijk na de betaling). Het feedbackverzoek wordt kort na het einde van het betaalproces verzonden. Het feedbackverzoek zal een achtergrondtaak zijn en kan niet worden gebruikt om de klant op uw website gepersonaliseerde feedback te sturen. Als u uw pagina na betaling niet gebruikt om een antwoord voor uw klant te personaliseren, kunt u het feedbackverzoek op de achtergrond en uitgesteld ontvangen. Altijd online (onmiddellijk na de betaling om zo het resultaat in rekening te kunnen nemen voor het antwoord aan de klant). Het feedbackverzoek wordt 'online' verstuurd tussen de ontvangst van het antwoord van de acquirer door ons systeem en het moment waarop ons systeem de klant in kennis stelt van het resultaat van de betaling. In dit geval duurt het betaalproces langer voor de klant, maar kunt u de klant een gepersonaliseerd antwoord sturen. Het nadeel van het onlinefeedbackproces na betaling is dat de prestaties van uw systeem kunnen afnemen als er te veel verzoeken naar uw pagina na betaling worden verstuurd (bijvoorbeeld een groot aantal transacties per minuut) dit kan ertoe leiden dat de klanten lang moeten wachten voordat ze feedback op het scherm te zien krijgen. Online, maar schakel over op uitgestelde requests (met intervallen) wanneer de online requests fout lopen Met deze optie heeft een handelaar die onlinefeedback na betaling vereist (om het antwoord dat de klant te zien krijgt aan te passen) een terugvaloptie mocht het onlineverzoek op zijn pagina na betaling mislukken. In dit geval zullen we het feedbackverzoek om de 10 minuten opnieuw proberen, met een maximum van vier keer (uitgesteld). Op die manier mist u de transactiefeedback niet indien het onlinefeedbackverzoek na betaling mislukt, bijvoorbeeld als gevolg van tijdelijke problemen met uw server. De klant krijgt de standaardtransactiefeedback van ons systeem te zien (zie Standaardreactie) Antwoord aan de klant We gebruiken een mogelijk antwoord van uw pagina na betaling om uw klant feedback (pagina aan het eind van de transactie) te tonen. Als uw pagina na betaling antwoordt met: een html-pagina (die een <html> -tag) of een omleiding (HTTP 302 Object verplaatst) bevat, stuurt ons systeem die html-pagina ongewijzigd naar de browser van de klant of voert het de omleiding uit, in plaats van uw klant aan het eind van uw feedbackproces na betaling om te leiden naar één van de vier redirectie-url's die u eventueel hebt verzonden in de verborgen velden zoals beschreven in Redirectie afhankelijk van het betaalresultaat). Als u daarentegen geen van de bovenstaande gebruikt als feedback aan uw klant, kunt u uw pagina na betaling laten antwoorden met een paar regels tekst (geen <html> -tag) die we zullen opnemen in ons standaardantwoord, of zal ons systeem gewoon het standaardantwoord weergeven (zoals beschreven in: Standaardreactie) Het onderstaande diagram toont het proces aan het eind van een transactie, indien de betaling is geautoriseerd of aanvaard, bij een onlineverzoek na betaling. (Wanneer de betaling geannuleerd, geweigerd of onzeker is, is het proces vergelijkbaar maar worden in plaats daarvan de "CANCELURL", "DECLINEURL", "EXCEPTIONURL" en de "annulerings/weigerings"-pagina's gebruikt). Page 37 of 48-21/06/2016

39 7.4.4 HTTP request voor statusveranderingen Als u ook een uitgesteld http-verzoek wilt ontvangen bij een wijziging van de transactiestatus, kunt u een extra URL instellen in het veld "HTTP-request voor statusveranderingen" op het tabblad "Transactiefeedback" van uw "Technische instellingen"-pagina (en de timing voor het verzoek selecteren). Dit is vergelijkbaar met een URL na betaling, met het verschil dat het relevant is voor mogelijke achtergrondprocessen. U kunt hier dezelfde URL gebruiken als de URL die is ingesteld in het deel "Direct HTTP server-to-server request". Opmerking: deze URL kunt u niet gebruiken om een persoonlijk antwoord voor de klant te genereren. 7.5 Feedback parameters Wanneer een transactie is uitgevoerd, kunnen we de volgende parameterlijst naar uw redirectie-url's en/of post-payment feedback-url's verzenden. Veld Omschrijving ACCEPTANCE De door de acquirer teruggestuurde autorisatiecode Bedrag (niet vermenigvuldigd met 100) amount Decimalen worden enkel teruggestuurd wanneer relevant, bv. 15, 15.1, BRAND Merk van de kaart (ons systeem leidt dit af van het kaartnummer) Page 38 of 48-21/06/2016

Nog meer weergeven