Page 1

BPE 3.0 Plugin for Prestashop 1.5.x. Installatie handleiding

Versie: 1.0.2 Jaar: 2013 Auteur: Buckaroo Online Payment Services


Revision Sheet Revision 1.0.1 1.0.2

Date 08-08-2013 22-10-2013

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright Š 2013 Buckaroo BV, Nederland

Brief Summary of Changes Baseline document draft Uitbreiding in algemene settings


1.

INTRODUCTIE .................................................................................................................................. 1 1.1

2.

INSTELLINGEN EN GEGEVENS IN DE BUCKAROO PAYMENT PLAZA .................................................. 2 2.1 2.2

3.

INSTELLINGEN IN DE BUCKAROO PAYMENT PLAZA ....................................................................................... 2 GEGEVENS UIT DE BUCKAROO PAYMENT PLAZA ........................................................................................... 4

INSTALLATIE IN DE PRESTASHOP ..................................................................................................... 6 3.1 3.2

4.

ONDERSTEUNDE BETAALMETHODE ........................................................................................................... 1

INSTALLEREN VAN DE PLUGIN .................................................................................................................. 6 BPE 3.0 PLUGIN INSTALLATIE VIA HET ADMINPANEL .................................................................................... 6

CONFIGURATIE................................................................................................................................ 8 4.1 4.2

ALGEMENE SETTINGS ............................................................................................................................. 8 BETAALMETHODE SETTINGS .................................................................................................................... 9

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright © 2013 Buckaroo BV, Nederland

i


1. Introductie Dit is de installatie handleiding voor de Buckaroo “BPE 3.0 Plugin voor PrestaShop”. De Plugin is gemaakt voor PrestaShop versie 1.5.x. 1.1 Ondersteunde betaalmethode In de “BPE 3.0 Plugin voor PrestaShop” worden de volgende betaalmethoden ondersteund:           

iDEAL PayPal eM!Payment Payment Guarantee Giropay paysafecard Bancontact / Mister Cash Giftcard Creditcard (Mastercard,Visa,Amex,eMaestro,Vpay) Sofortbanking Overschrijving

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright © 2013 Buckaroo BV, Nederland

1


2. Instellingen en gegevens in de Buckaroo Payment Plaza 2.1 Instellingen in de Buckaroo Payment Plaza Voor de installatie van de Buckaroo module dient u enkele onderdelen in te stellen in de Buckaroo Payment Plaza. Voer daartoe de volgende stappen uit: 1. Log in op het Payment Plaza van Buckaroo 2. Ga naar Profiel > Websites > Uw website 3. Hier vindt u het volgende formulier

Figuur 1. Instellingen in de Payment Plaza van Buckaroo

4. Onder het tabblad “Redirect” kunnen de invoervelden leeg gelaten worden:

Figuur 2. Redirect instellingen in het Payment Plaza van Buckaroo

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright © 2013 Buckaroo BV, Nederland

2


5. Onder het tabblad “Push settings” dient u de volgende instellingen te maken:

Figuur 3. Push settings instellingen in het Payment Plaza van Buckaroo

a. De checkbox “Enable Push Response” dient aangevinkt te zijn. b. De velden ‘URI succes’ en ‘URI failed’ moeten beiden gevuld worden met een URL van uw website. Het gaat hier om http://<basis URL van uw website>?fc=module&module=buckaroo3&controller=return De basis URL van uw website zal in de meeste gevallen de vorm van ‘www.uwwebsite.nl’ volgen. Er zijn hier echter ook uitzonderingen op. De meest voorkomende uitzonderingen zijn ‘www.uwwebsite.nl/index.php’ en ‘www.uwwebsite.nl/NL’ of een combinatie van beide. Om erachter te komen welke basis URL uw website gebruikt gaat u naar de voorpagina van uw website en klikt u op enkele links. Steeds kijkt u naar de URL van de pagina waar u zich bevindt. Het deel aan het begin van de URL dat steeds gelijk blijft, is uw basis URL. c. Gebruik HTTP-Method moet op “POST” staan. d. Voor “Push type” select “BPE3.0”. e. De Hash method moet op “SHA1” staan. f. Bij “BPE 3.0 returnvelden” dient u “Lowercase letters” of “Kleine letters” te selecteren. g. De optie “E-Mail push mislukt” is optioneel. Wij versturen een e-mail naar dit e-mail adres als een push bericht mislukt. 6. Het tabblad “3.0 settings”:

Figuur 4. 3.0 Settings in het Payment Plaza van Buckaroo

a. Met de optie ‘’Gateway taalkeuze actief” kan de klant, wanneer deze zich op de Buckaroo betaalpagina bevindt, zelf een andere taal selecteren. Vink deze optie aan om dit te activeren. b. De optie “Activeer dubbel encoding op redirect data” kan uitgevinkt blijven. 7. Het tabblad “2.0 Instellingen”: Deze tab geeft geen opties om in te stellen.

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright © 2013 Buckaroo BV, Nederland

3


2.2 gegevens uit de Buckaroo Payment Plaza

Aanmaken van keys en certificaat Voor de verificatie van de module wordt er gebruik gemaakt van een aantal keys en een certificaat. Deze zijn later nodig bij het instellen van de module in uw Presta webwinkel.

(Merchant) Key: De ‘(Merchant) Key’ kunt u vinden in het Payment Plaza onder: Profiel > Websites > Uw website (zie figuur 5. ).

Figuur 5. (Merchant) Key

Secret Key: De ‘Secret Key’ kunt u vinden in het Payment Plaza onder: Configuratie > Secret Key voor Digitale Handtekening (zie figuur 6. ).

Figuur 6. Secret key

Aanmaken certificaat De certificaten kunt u vinden in het Payment Plaza onder: Configuratie > Beheer certificaten (BPE 3.0). Klik hier op de optie ‘Make certificate’ (zie figuur 7. ).

Figuur 7. Certificaten in de Payment Plaza

Zorg ervoor dat in de vervolg stap de ‘Export key as:’ op ‘PEM’ staat, ‘Purpose’ op ‘General’ en ‘Active’ aangevinkt is (zie figuur 8. ).

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright © 2013 Buckaroo BV, Nederland

4


Figuur 8. Instellingen voor het certificaat

Klik nu op “Make certificate’ en download het bestand. Het is hierbij van belang dat de naam ongewijzigd blijft. Dit bestand is uw nieuwe privésleutel, die door de module gebruikt zal worden om de authenticiteit van binnenkomende en uitgaande betalingsverzoeken te bevestigen. Bewaar dit bestand zorgvuldig en op een veilige locatie. Het is niet mogelijk om dit bestand nogmaals te downloaden. Als u het bestand verliest, dient u een nieuwe aan te maken. Na het downloaden van het certificaat kan het venster worden gesloten. Het certificaat ziet u nu terug in het overzicht gesorteerd op datum. Achter elk certificaat staat een Thumbprint (zie figuur 9. ), deze heeft u later nog nodig bij het instellen van de module in Prestashop. Let er op dat de “Thumbprint” van het zojuist aangemaakte certificaat wordt gebruikt. Als een “Thumbprint” van een ander certificaat wordt gebruikt is het niet mogelijk om transacties te doen.

Figuur 9. Thumbprint van uw certificaat

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright © 2013 Buckaroo BV, Nederland

5


3. Installatie in de PrestaShop 3.1 Installeren van de Plugin De eerste stap is het installeren van de BPE 3.0 plugin voor PrestaShop in de webshop. De laatste versie is te downloaden op de payment plaza onder Support. Het zip bestand dat wordt gedownload dient lokaal te worden opgeslagen. Dit zip bestand wordt gebruikt om de plugin te installeren. Er zijn verschillende manieren om de extension module(plugin) te installeren in PrestaShop. Wij raden aan om de BPE 3.0 plugin te installeren via het adminpanel van PrestaShop. Dit is de makkelijkste methode om de installatie te voltooien. Het kan voorkomen dat deze installatie methode niet werkt. Als dit het geval is kan er een andere methode worden gebruikt. De uitleg voor alternatieve installatie methode is te vinden via de volgende link: http://addons.prestashop.com/en/content/21-how-to

3.2 BPE 3.0 Plugin installatie via het adminpanel In de modules tab (Figuur 2.1) klikt u op modules. Klik vervolgens op add a new module (Figuur 2.2).

Figuur 2.1 Modules dropdown menu

Figuur 2.2 Add a new module button

Klik onder “Add a new module” op “Choose File”. Selecteer het zip bestand dat is gedownload. Klik vervolgens op Upload this module (Figuur 2.3). Als de melding “Unknown archive type” verschijnt is de PHP extensie php_zip niet geïnstalleerd op de gebruikte server. U zult deze eerst zelf of via uw hostingprovider moeten laten installeren voor deze installatie methode.

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright © 2013 Buckaroo BV, Nederland

6


Figuur 2.3 Add new module

Als de installatie succesvol is verlopen verschijnt de melding â&#x20AC;&#x153;module downloaded sucessfullyâ&#x20AC;? (figuur 2.4).

Figuur 2.4 succesvolle instalatie melding

De module staat nu in de lijst met modules onder de Module tab (figuur 2.5).

Figuur 2.5 Buckaroo plugin in de lijst met modules

Klik op de install knop om de module te installeren. De optie Configure is nu als optie beschikbaar, klik hierop om de module te configureren. Opmerking: Als de webshop beschikbaar is voor klanten en de module nog niet volledig is geconfigureerd, zet de module dan op disabled.

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright Š 2013 Buckaroo BV, Nederland

7


4. Configuratie Om de module te configureren klik op “Configure” onder de module beschrijving. 4.1 Algemene settings De eerste configuratie op Global settings (figuur 4.1). Alle velden die u hier ziet dienen ingevuld te worden.

Figuur 4.1 Global settings

Setting

Description

Mode (Test/Live)

Hier kunt u de module in de ‘test’ of de ‘live’ modus zetten. Let op: Test transacties worden in het Payment Plaza geregistreerd. U kunt een aparte testomgeving aanvragen bij Buckaroo Merchant key* Vul hier uw ‘(Merchant) Key’ in. U kunt deze vinden door in te loggen in het Buckaroo Payment Plaza. Ga vervolgens naar Profiel > Websites en selecteer uw website. Bovenaan het getoonde formulier kunt u uw (Merchant) Key vinden Secret key* Vul hier uw ‘Secret Key’ in. U kunt deze vinden door in te loggen in het Buckaroo Payment Plaza. Ga vervolgens naar Configuratie > Secret Key voor Digitale Handtekening Certificate* Selecteer hier uw certificaat. Certificate thumbprint* Vul hier uw ‘Thumbprint’ in welke bij het aangemaakte certificaat hoort. Transaction label Vul hier de omschrijving van de betaling in. Deze beschrijving wordt getoond bij betalingen in het Buckaroo Payment Plaza Return url Pagina waarnaar de redirect wordt gedaan na de betaling. Pas deze url niet aan, tenzij dit nodig is voor een correcte werking van de plugin. Language Hier kan een vaste taal worden gekozen die naar Buckaroo wordt doorgestuurd bij de betaling. Als er wordt gekozen voor “Use webshop culture” de plugin gebruikt de webshop culture. Let op: er worden 4 talen ondersteund: Engels, Nederlands, Frans en Duits. (* Voor de uitleg over de inhoud van deze velden zie hoofdstuk 2)

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright © 2013 Buckaroo BV, Nederland

8


4.2 Betaalmethode settings Standaard zijn alle betaalmethoden disabled. Om deze op enabled te zetten kies “Yes” bij de “Enable” optie.

Elke betaalmethode kan worden ingesteld voor Live of Test mode.

Sommige betaalmethoden hebben aanvullende settings. Als voorbeeld de Payment Guarantee instellingen waar het aantal dagen tussen order en invoice kan worden ingesteld.

Installatie handleiding B.P.E. 3.0 plugin for Prestashop 1.5.x Copyright © 2013 Buckaroo BV, Nederland

9

Buckaroo Prestashop handleiding  

Buckaroo Prestashop handleiding 2014

Read more
Read more
Similar to
Popular now
Just for you