Hoe stap ik over naar Buckaroo

Laatst bijgewerkt op
Als PDF opslaan

Deze pagina beschrijft de stappen die je als bibliotheek moet nemen om Buckaroo in te stellen als online betaalmethode in de Wisecat+.

Let op: Het testen van de koppeling kun je het beste doen op je acceptatieserver. Je kunt hiervoor je Buckaroo account koppelen met de acceptatieserver.

Onboarding bij Buckaroo

Bij Buckaroo moet een account aangemaakt worden om deze te koppelen aan Wise.

Je vult bij het veld 'Website' de URL in van de bibliotheekorganisatie.

Personaliseer checkout bij Buckaroo

Je kunt kunt de betaalpagina bij een Buckaroo-betaling personaliseren. Dit doe je als volgt in het dashboard van Buckaroo:

Log in
Ga naar Instellingen > Weergave betaalpagina
Voeg je website toe (knop rechtsbovenin)
Klik op je website
Upload het logo van je bibliotheek
Kies een achtergrondafbeelding

Koppel Buckaroo aan Wise

Buckaroo Plaza

Om betalingen via Buckaroo te laten verlopen moeten er een aantal aanpassingen gedaan worden in de Wise Manager met gegevens uit het Buckaroo Plaza. Binnen het Buckaroo Plaza navigeer je naar 'Instellingen' en dan naar 'API keys'.

Er bestaan geen verschillen tussen een productie secret key en een test secret key, wanneer dit op een test of acceptatie server wordt ingesteld weet Wise automatisch dat het naar de test website moet van Buckaroo.

Wise Manager

Om gebruik te kunnen maken van de online betaalmethode Payment Provider moet eerst de systeemoptie 'PSPCONF' aangezet worden. Dit kan op systeem- of instantieniveau.

Let op: de koppeling werkt alleen in de nieuwe Wisecat+. Pas als deze actief is (systeemoptie OPAV2L), zal de koppeling naar Buckaroo aangezet kunnen worden.

Met de gegevens uit het Buckaroo Plaza kun je nu een nieuwe online betaalmethode creëren, welke je voor Buckaroo kunt gebruiken.

In de Wise Manager navigeer je hiervoor naar Wise > Financiën > (Systeem)tabellen > Online betaalmethode

Bij 'Soort Online betalingen' selecteer je 'PP - Payment Provider', vervolgens komen er een aantal opties beschikbaar. Bij 'Payment Provider' selecteer je 'Buckaroo', en bij 'Website Key' vul je de 'Website key' uit het Buckaroo Plaza in, en bij 'Payment Provider API key' vul je de 'Secret key' uit het Buckaroo Plaza in. Het veld 'Return url' kan gebruikt worden als je na de betaling bij een andere pagina uit wil komen dan in de Wisecat+.

Nu er een online betaalmethode gedefinieerd is voor Buckaroo kun je een instantie aansluiten op deze online betaalmethode.

Online betaalmethode activeren in de Wisecat+

In de Wise Manager navigeer je naar Wise > Beheer organisaties > Instanties. Selecteer de instantie waar je de online betaalmethode aan wilt toevoegen

Wanneer deze instelling gezet wordt, zullen betalingen via de Wisecat+ klanten naar Buckaroo sturen zodra een betaling verwacht wordt. De wijziging gaat per direct in.
Na deze betaling komen ze weer terug in de Wisecat+, waar ze de status van hun betaling kunnen zien. Wanneer een betaling gedaan is bij Buckaroo wordt de administratie in Wise verwerkt en zal Buckaroo deze uitbetalen op basis van de opties die gedefinieerd staan bij Buckaroo.

Aparte instellingen voor Joomla

Om Joomla goed te laten werken zijn er aparte instellingen nodig in de Wise Manager. Per Joomla-omgeving moet er een online betaalmethode gedefinieerd worden, welke gekoppeld moet worden aan de instantie.

Bij het definiëren van de betaalmethode is er een extra veld genaamd 'Return url'. Deze moet gebruikt worden om goed terug te keren vanuit de desbetreffende Payment Provider naar Joomla. Dit ziet er als volgt uit:

https://[joomla-domein]/wise-apps/opac/{branchId}/basket/{btxid}/paymentresult

De gegevens tussen de [blokhaken] vervang je door de gegevens waar het Joomla domein zich bevindt.

Wat kan ik zien bij Buckaroo?

Op het Plaza van Buckaroo is er de mogelijkheid om gegevens in te zien van de betalingen die aangemaakt zijn.

Als je een transactie selecteert, dan kun je gedetailleerde gegevens inzien.

In de database worden de transacties ook gekenmerkt met een Buckaroo kenmerk.

Dagboekgebruik

Momenteel zullen er nog geen veranderingen plaatsvinden bij het dagboekgebruik. Betalingen die via Buckaroo plaatsvinden worden onder de noemer "iDEAL" geregistreerd: dagboekfunctie 'iDEAL' moet nog steeds worden gebruikt voor betalingen via Buckaroo. Binnen het dashboard van Buckaroo is er de mogelijkheid om meer inzicht te krijgen over de vormen van betalingen die zijn gebruikt.

iDEAL machtiging

Om een machtiging te ondersteunen is het belangrijk dat in ieder geval de betaalmethode iDEAL actief is binnen Buckaroo. Op het moment dat een klant kiest om een machtiging af te geven tijdens het winkelmandje proces, zal de klant niet meer de mogelijkheid krijgen om te kiezen voor verschillende betaalmethodes, maar zal de klant worden geforceerd om iDEAL te gebruiken.

Zolang de klant iDEAL gebruikt, zal de afhandeling voor het machtigen van de incasso goed verlopen, en zullen de IBAN en tenaamstelling van de klant goed opgeslagen worden. Hiervoor hoef je zelf geen dingen te regelen.