Handleiding voor de implementatie van de Buckaroo PSP plug-in voor
Versie 1.1
Inhoud Inleiding ................................................................................................................................................................ 2 Instellingen en gegevens in Buckaroo Payment Plaza ...................................................................................... 2 (Merchant) Key ................................................................................................................................................ 4 Secret Key ........................................................................................................................................................ 4 TYPO3 Multishop ................................................................................................................................................. 4 Implementatie van de plugin in TYPO3.............................................................................................................. 4 Configuratie betaalmethodes in TYPO3 Multishop .......................................................................................... 5 Aanpassen .htaccess ....................................................................................................................................... 8 Schrijfwijze betaalmethodes .......................................................................................................................... 9 Giftcard codes.................................................................................................................................................. 9 Afronden configuratie ....................................................................................................................................... 10
Pagina 1 van 11
Inleiding Aan de hand van de TYPO3 Multishop Buckaroo plug-in is het mogelijk om betalingen door middel van Buckaroo te ontvangen. Aan de hand van deze plug-in en uw Buckaroo account zijn de volgende betaalmethodes mogelijk: Eenmalige machtiging iDEAL Mastercard creditcard Bankoverschrijving PayPal EM payments Mr. Cash
Giropay Meastro creditcard Sofort Visa creditcard Paymentguarantee Giftcard
Let op: deze plug-in is alleen werkzaam met TYPO3 Multishop versie 3.x. Als u een oudere versie hanteert dan dient u deze eerst te upgraden. Zie voor de downloadlinks het hoofdstuk TYPO3 Multishop.
Instellingen en gegevens in Buckaroo Payment Plaza Voor de installatie van de TYPO3 Multishop Buckaroo plug-in dient u eerst enkele onderdelen in te stellen in het Buckaroo Paument Plaza. In deze dient u de volgende stappen uit te voeren: 1. Log in op het Payment Plaza van Buckaroo 2. Ga naar Profiel > Websites > Uw website 3. Hier vindt u het volgende formulier
4. Onder het tabblad Redirect kunnen de invoervelden leeg gelaten worden:
Pagina 2 van 11
5. Onder het tabblad Push settings dient als volgt ingesteld te worden:
De checkboxes Enable Push Response dient aangevinkt te zijn. De velden URI succes en URI failed moeten beiden gevuld worden met een URL van uw website. Het gaat hier om : Success: http://
/psp_accepturl/ Failure: http:///psp_cancelurl/ 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, dat is uw basis URL. Gebruik HTTP-Method moet op POST staan. Voor Push type selecteer BPE3.0. De Hashmethod moet op SHA1 staan. Bij BPE 3.0 returnvelden dient u Lowercase letters of Kleine letters te selecteren. 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”:
Pagina 3 van 11
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. 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.
(Merchant) Key De ‘(Merchant) Key’ kan u vinden in het Payment Plaza onder: Profiel > Websites > Uw website
Secret Key De ‘Secret Key’ kan u vinden in het Payment Plaza onder: Configuratie > Secret Key voor Digitale Handtekening.
TYPO3 Multishop Indien u TYPO3 Multishop nog niet in uw bezit heeft kunt u deze kosteloos downloaden via deze URL. De implementatie handleiding van TYPO3 Multishop kunt u downloaden door middel van deze URL.
Implementatie van de plugin in TYPO3 Om de TYPO3 Multishop Buckarooplug-in te implementeren dient u eerst in te loggen in uw TYPO3. Dit is mogelijk via http://www.uwdomeinnaam.ext/typo3/.
Pagina 4 van 11
Zodra u bent ingelogd selecteert u aan de linkerzijde van het TYPO3 menu de functie extension manager. Aan de hand daarvan kunt u bestaande plug-ins configureren maar ook nieuwe plug-ins installeren. Selecteer vervolgens aan de bovenzijde van het scherm het upload icoon om de TYPO3 Multishop Buckarooplug-in te installeren.
Na selectie van het upload icoon zoekt u de gedownloade plug-in op uw computer. Klik vervolgens op de knop upload extension fromyour computer om de plug-in te uploaden in uw TYPO3 installatie. Klik, nadat de plug-inis geüpload, op het icoontje voor de Multishop Buckarooplug-in (het blokje met + teken) om de plug-in in uw TYPO3 systeem te implementeren.
Zodra de plug-inis geïnstalleerd klikt u op de link close window om de implementatie van de plug-in af te sluiten.
Configuratie betaalmethodes in TYPO3 Multishop Nadat de TYPO3 Multishop Buckarooplug-in is geïmplementeerd binnen uw TYPO3 installatie kunt u uw betaaloplossingen configureren. Hiervoor logt u in op het beheerpaneel van TYPO3 Multishop en
Pagina 5 van 11
selecteert u vervolgens een de onderzijde de optie systeem, gevolgd door verzenden betaalmethodes. In het menu wat hierop volgt selecteert u vervolgens de optie betaalmethodes om uw betaalmethodes voor Buckaroo te installeren.
Pagina 6 van 11
Zodra u de optie betaalmethodes geselecteerd hebt klikt u op betaalmethode toevoegen om Buckaroo toe te voegen aan uw TYPO3 Multishop.
Er volgt vervolgens een overzicht van alle mogelijke (geïnstalleerde) betaaloplossingen. Selecteer in dit overzicht de optie addBuckaroo onder het Buckaroo logo.
Na selectie van addBuckaroo zal het overzicht alle benodigde informatie voor de betaalmethode tonen. In deze voert u de benodigde informatie in. Naam: geef hier de naam in voor de betaalmethode, bijvoorbeeld iDEAL. Zie voor de correcte schrijfwijze van alle methodes het hoofdstuk schrijfwijze betaalmethodes”. Korte omschrijving: u kunt hier een optionele omschrijving voor de betaalmethode ingeven. Bijvoorbeeld via deze optie kunt u via iDEAL betalen. Deze zal vervolgens tijdens het betaalproces worden getoond onder de betaalmethode. Code: geef in dit veld de code in voor Multishop zodat deze de betaalmethode kan herkennen, bijvoorbeeld ideal. Verwerkingskosten: in deze optionele velden kunt u eventuele verwerkingskosten ingeven. BTW tarief: indien u gebruik maakt van verwerkingskosten kiest u in dit veld de betreffende BTW waarde. BPEWebsitekey: in dit veld geeft u uw website code in.
Pagina 7 van 11
BPESecretkey: in dit veld geeft u uw secretkey in BPECulture: geef in deze de waarde nl_NL in voor de Nederlandse taal. Paymentmethod: selecteer in deze de gewenste betaalmethode, bijvoorbeeld iDEAL. Giftcard servicecode: indien van toepassing, geef in dit veld uw giftcard servicecode in. Zie voor deze het hoofdstuk Giftcard codes voor de mogelijke coderingen. Success status: selecteer in dit veld de orderstatus voor een succesvolle betaling. Cancelled status: selecteer in dit veld de orderstatus voor een geannuleerde betaling. Failed status: selecteer in dit veld de orderstatus voor een betaling die mislukt is. Test: selecteer of de betaaloplossing in test- of productiemode moet worden geplaatst. Autosubmit: selecteer of Multishop direct contact moet maken met Buckaroo zodra uw klant de checkoutverlaat (wij adviseren u in deze om de waarde op true te zetten). Open in new window: selecteer hier of het betaalscherm van Buckaroo in een nieuw venster moet openen (wij adviseren u om de waarde op false te zetten).
Aanpassen .htaccess Om een goede communicatie met de server van Buckaroo mogelijk te maken dient u de volgende waardes toe te voegen in de .htaccess file van uw TYPO3 installatie. Heeft u hiertoe geen toegang, neemt u dan contact op met uw systeembeheerder. RewriteEngine On RewriteCond %{REQUEST_URI} ^/buckaroo/success/ RewriteRule .* /index.php?id=5&type=2002&tx_multishop_pi1\%5Bpage_section\%5D=psp&tx_multishop_pi1\%5Bpa yment_lib\%5D=buckaroo&tx_multishop_pi1\%5Bpayment_section\%5D=success [P,L,QSA] RewriteCond %{REQUEST_URI} ^/buckaroo/cancelled/ RewriteRule .* /index.php?id=5&type=2002&tx_multishop_pi1\%5Bpage_section\%5D=psp&tx_multishop_pi1\%5Bpa yment_lib\%5D=buckaroo&tx_multishop_pi1\%5Bpayment_section\%5D=cancelled [P,L,QSA] RewriteCond %{REQUEST_URI} ^/buckaroo/failed/
RewriteRule .* /index.php?id=5&type=2002&tx_multishop_pi1\%5Bpage_section\%5D=psp&tx_multishop_pi1\%5Bpa yment_lib\%5D=buckaroo&tx_multishop_pi1\%5Bpayment_section\%5D=failed [P,L,QSA]
Pagina 8 van 11
Schrijfwijze betaalmethodes Buckaroo hanteert standaard gemakkelijk te begrijpen namen voor haar betaalmethodes. Wij adviseren u dan ook deze te gebruiken bij het ingeven van de benaming voor uw betaalmethode. Zie onderstaand overzicht voor de correcte benamingen: Diverse betaalmethode Achterafbetalen Giropay iDEAL Machtiging
Bancontact/ Mister Cash
Online giro Overboeking PayPal Sofortbanking EPS
èM! Payment Creditcards American Express eMeastro Mastercard MastercardSecureCode Carte Bleue Visa
Visa Verifiedby Visa Visa Electron V Pay
Cadeaukaarten/Loyalty babygiftcard e-bon fashioncheque Fijncadeau Ippies.nl kook-cadeau
NationaleEntertainmentCard NationaleTuinbon PODIUM Cadeaukaart WebshopGiftcard YourGift Card BOEKEN BON
Prepaid/voucher Ukash
paysafecard
Giftcard codes Naamgiftcard Baby Giftcard BabyparkGiftcard Beauty Wellness Boekenbon Boekenvoordeel Designshops Giftcard Fijn Cadeau Koffie Cadeau Koken En Zo Kook Cadeau
Code babygiftcard babyparkgiftcard beautywellness boekenbon boekenvoordeel designshopsgiftcard fijncadeau koffiecadeau kokenzo kookcadeau
Pagina 9 van 11
Nationale Entertainment Card Natures Gift Podium Cadeaukaart Shoes Accessories Webshop Giftcard Wijn Cadeau Wonen En Zo Your Gift Fashioncheque
nationaleentertainmentcard naturesgift podiumcadeaukaart shoesaccessories webshopgiftcard wijncadeau wonenzo yourgift fashioncheque
Afronden configuratie Selecteer vervolgens de knop opslaan om uw wijzigingen op te slaan. Herhaal, indien nodig (bij meerdere betaalmethodes) de stappen onder Configuratie betaalmethodes in TYPO3 Multishop.
Pagina 10 van 11
