Buckaroo
Handleiding Versie 3.0
088 990 7700 –
[email protected] www.ccvshop.nl
Inhoudsopgave Inhoudsopgave
2
Changelog
3
1. Inleiding
4
2. Aanmelden Buckaroo
6
2.1 Tabblad: algemeen
7
2.2 Tabblad: redirect
7
2.3 Tabblad: Push instellingen
8
2.4 Tabblad: 2.0 Instellingen
9
2.5 BPE2.0: Digitale Handtekening - secret key
9
2.6 BPE3.0: Certificaat aanmaken
9
3. Instellingen CCV Shop
11
3.1 Versie BPE 2.0
11
3.2 Versie BPE 3.0
12
4. Vragen?
Pagina 2 – Handleiding: Buckaroo
15
Changelog Datum
Versie
Opmerking
18-04-2013
1.0
Initiële opzet
20-06-2015
2.0
Nieuwe lay-out
14-04-2016
3.0
Aanpassingen aanmelding
Pagina 3 – Handleiding: Buckaroo
1. Inleiding CCV Shop heeft een koppeling met de Payment Service Provider Buckaroo. Buckaroo is sinds 2005 leverancier van betaaloplossingen in Nederland, gespecialiseerd in billing & payments voor bedrijven en online payments voor webwinkeliers. Met ruim 4.500 klanten en 200 (web)partners is Buckaroo de bepalende Payment Service Provider in Nederland. Buckaroo heeft een breed scala aan betaaloplossingen die u de mogelijkheid geven om uw gehele betaal- en incassoproces en bijbehorende administratie volledig te automatiseren. Met een groot aantal aan (internationale) betaalmethoden en een volledig gedigitaliseerd facturatiesysteem bespaart u veel tijd op backoffice werkzaamheden. Bent u in de gelegenheid om uw betalingen en vorderingen sneller en klantvriendelijker te innen. Met de Buckaroo betaalsystemen kunt u als webwinkelier op een veilige en eenvoudige wijze online betaalmethoden aanbieden op uw webshop, waaronder: •
iDEAL
•
Creditcards
•
PayPal
•
Bancontact/ Mister Cash
•
Giropay
CCV Shop ondersteunt op dit moment twee implementaties van Buckaroo, namelijk versie 2 en versie 3. Buckaroo bepaalt welke versie actief is in uw webwinkel. In deze handleiding staat beschreven hoe u Buckaroo koppelt aan uw webwinkel. Voor het activeren van de koppeling worden geen extra kosten in rekening gebracht. Buckaroo kent daarentegen wel kosten voor het gebruik.
Pagina 4 – Handleiding: Buckaroo
Let op! U dient pakket M of L bij CCV Shop af te nemen om gebruik te kunnen maken van dit betaalsysteem.
Pagina 5 – Handleiding: Buckaroo
2. Aanmelden Buckaroo Indien u gebruik wilt maken van Buckaroo dan dient u de volgende stappen uit te voeren: 1. U meldt zich aan bij Buckaroo via het aanvraagformulier op de website, telefonisch (+31 (0)30-7115000) of per e-mail (
[email protected]). Geef hierbij aan dat u een webwinkel bij CCV Shop heeft. 2. U ontvangt per e-mail de Buckaroo aansluit- en gebruiksovereenkomst, aanvullende informatie en indien van toepassing aanvullende voorwaarden. 3. U ondertekent de overeenkomst en stuurt deze samen met de volgende documenten retour: -
Aansluit- en gebruiksovereenkomst;
-
Ingevuld UBO-formulier;
-
Een kopie legitimatiebewijs van de tekenbevoegde persoon;
-
Een kopie afschrift bankrekening niet ouder dan 3 maanden of een kopie van de bankpas (voor- en achterkant).
4. Zodra Buckaroo de door u ingevulde overeenkomst en bijlagen heeft ontvangen, wordt binnen 48 uur uw account aangemaakt en ontvangt u uw logingegevens voor de Buckaroo Payment Plaza.
Gebruik de logingegevens die u van Buckaroo heeft gekregen om in te loggen voor de Payment Plaza. Navigeer in de Payment Plaza naar ‘Profiel - Websites’. Vervolgens klikt u op de website en verschijnt er een scherm met instellingen (figuur 1).
Pagina 6 – Handleiding: Buckaroo
Figuur 1
2.1 Tabblad: algemeen Bij het tabblad ‘Algemeen’ zijn er twee zaken die u moet instellen: Naam koppeling Geef de koppeling een naam. Deze naam is voor uw eigen herkenning. Url Vul hier de domeinnaam van uw webwinkel volledig in, dus inclusief http:// ervoor.
2.2 Tabblad: redirect Bij het tabblad ‘Redirect’ zijn er vier url’s die ingesteld moeten worden. Hier dient u de zogenaamde return url in te vullen. Deze return url is voor elk van de opties hetzelfde, namelijk: https://uw_domeinnaam/return.php.
Figuur 2
Pagina 7 – Handleiding: Buckaroo
2.3 Tabblad: Push instellingen Bij het tabblad ‘Push instellingen’ dient u meerdere instellingen in te vullen (figuur 3). De beveiligde domein haalt u uit uw onderhoudstool van CCV Shop via: ‘Startpunt – mijn webshop – Instellingen – Algemeen – Domeinen’. Hieronder nemen we ze stap voor stap door.
•
Zet een vinkje bij ‘Push response aan’.
•
Zet een vinkje bij ‘Activeer Push van Refunds’.
•
Push URL Success : https://
.securearea.eu/return.php
•
Push URL failure
•
Gebruik HTTP-Method
: POST
•
Push type
: BPE3.0 (Alleen indien beschikbaar)
•
BPE 3.0 returnvelden
: Kleine letters
•
E-mail push mislukt
: [email protected]
Figuur 3
Pagina 8 – Handleiding: Buckaroo
: https://.securearea.eu/return.php
2.4 Tabblad: 2.0 Instellingen Op het tabblad ‘2.0 Instellingen’ staan een aantal instellingen die (indien nodig) door Buckaroo ingesteld zijn. Hier hoeft u zelf niets in te stellen.
2.5 BPE2.0: Digitale Handtekening - secret key Let op! Dit hoofdstuk behandelt de instellingen voor versie 2 van Buckaroo. Buckaroo bepaalt welke versie er actief is in uw webwinkel. Gebruikt u versie 3? Ga dan verder naar hoofdstuk 2.6. Bij de instellingen in CCV Shop heeft u een ‘Digitale handtekening’ nodig. Navigeer in uw Payment Plaza naar ‘Configuratie - Beveiliging - Secret key voor Digitale handtekening’.
•
Zet een vinkje bij ‘Activeer de Digitale handtekening op het aanbieden van transacties’.
•
Zet een vinkje bij ‘Activeer de Digitale handtekening op de response-pagina’s’.
•
Secret Key: Vul hier een zelf gekozen wachtwoord in bestaande uit cijfers en letters.
•
Klik op ‘Toepassen’.
Figuur 4
2.6 BPE3.0: Certificaat aanmaken
Pagina 9 – Handleiding: Buckaroo
Let op! Dit hoofdstuk behandelt de instellingen voor versie 3 van Buckaroo. Buckaroo bepaalt welke versie er actief is in uw webwinkel. Navigeer in de Payment Plaza naar ‘Configuratie - Beveiliging - Beheer certificaten (BPE 3.0)’.
Klik op “Maak certificaat”. • • • • •
Exporteer privésleutel als : PEM Gebruiksdoel : SOAP gateway Actief : Zet een vinkje bij actief Klik op “Maak certificaat”. Het certificaat wordt aangemaakt en zal door uw browser gedownload worden. Zorg ervoor dat u dit bestand goed bewaard.
Figuur 5
Pagina 10 – Handleiding: Buckaroo
3. Instellingen CCV Shop Naast de instellingen bij Buckaroo zijn ook een aantal instellingen in het onderhoudspanel van uw webwinkel nodig. In CCV Shop vindt u dit via ‘Mijn webshop - Instellingen - Bestelproces en voorraad - Betaalmethodes’. Afhankelijk van de versie van Buckaroo die u gebruikt zijn er verschillende instellingen. We bespreken versie 2 in hoofdstuk 3.1 en versie 3 in hoofdstuk 3.2.
3.1 Versie BPE 2.0
Pagina 11 – Handleiding: Buckaroo
Merchant key Vul hier de Merchant Key in die u van Buckaroo ontvangen hebt. Gateway versie Kies hier voor “Versie 2”. Digitale handtekening Vul hier de aangemaakte digitale handtekening in (secret key). Testmodus Wanneer dit aangevinkt is, komt u in een test checkout omgeving waar u de werking van de koppeling mee kunt testen. Vast bedrag/percentage Het bedrag of percentage dat u per betaalmethode instelt wordt meegerekend. Hierbij gaat het om een percentage van het bedrag aan bestelde producten. Zet een vinkje voor de betaalmethoden die u actief wilt hebben in uw webwinkel.
3.2 Versie BPE 3.0
Pagina 12 – Handleiding: Buckaroo
Pagina 13 – Handleiding: Buckaroo
Merchant key Vul hier de Merchant Key in die u van Buckaroo ontvangen hebt. Gateway versie Kies hier voor “Versie 3”. Certificaat Upload hier het certificaat welke u eerder bij Buckaroo hebt aangemaakt en gedownload. Thumbprint Vul hier de Thumbprint in die bij het certificaat hoort.Dit kunt u vinden in Payment Plaza bij ‘Configuratie - Beveiliging - Beheer certificaten (BPE 3.0)’. Testmodus Wanneer dit aangevinkt is, komt u in een test checkout omgeving waar de koppeling mee getest kan worden. Vast bedrag/percentage Het bedrag of percentage dat u per betaalmethode instelt wordt meegerekend. Hierbij gaat het om een percentage van het bedrag aan bestelde producten. Zet een vinkje voor de betaalmethoden die u actief wilt in uw webwinkel.
Pagina 14 – Handleiding: Buckaroo
4. Vragen? Ik heb een vraag over Buckaroo We hebben een uitgebreid supportteam dat altijd voor u klaarstaat om te helpen, mocht u vragen hebben of problemen tegenkomen. Van maandag t/m vrijdag zijn onze supportmedewerkers telefonisch bereikbaar via +31(0)88 990 7700 of per email via [email protected].
Pagina 15 – Handleiding: Buckaroo
Aansprakelijkheid CCV Shop heeft deze handleiding zelf opgesteld. Er kunnen fouten en onvolledigheden in deze uitgave voorkomen. Het gebruik van deze handleiding is geheel voor rekening en risico van de gebruiker. CCV Shop aanvaardt geen enkele aansprakelijkheid voor onjuistheden en onduidelijkheden in de tekst. Fouten of onvolledigheden verbeteren we graag. Zou u wanneer u onvolledigheden opmerkt, deze willen e-mailen naar [email protected]? Hartelijk dank hiervoor! Auteursrechten Alle rechten voorbehouden. Niets uit deze uitgave mag worden verveelvoudigd, opgeslagen in een geautomatiseerd gegevensbestand en/of openbaar gemaakt in enige vorm of op enige wijze, hetzij elektronisch, mechanisch, door fotokopieën, opnamen of op enige andere manier zonder voorafgaande schriftelijke toestemming van CCV Shop.
CCV Shop Diamantstraat 3 7554 TA Hengelo (Ov) +31 (0)88 990 7700 [email protected] www.ccvshop.nl
Pagina 16 – Handleiding: Buckaroo