Hoe stap ik over naar Mollie
Deze pagina beschrijft de stappen die je als bibliotheek moet nemen om Mollie in te stellen als online betaalmethode in de Wisecat+
Het testen van de koppeling kun je het beste doen op je acceptatieserver. Je kunt hiervoor je Mollie Test API-key koppelen met de acceptatieserver.
Onboarding bij Mollie
Bij Mollie 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 Mollie
Je kunt kunt de betaalpagina bij een Mollie-betaling personaliseren. Dit doe je als volgt in het dashboard van Mollie:
- Log in.
- Ga naar organisatie-instellingen
- Ga naar Profielen
- Klik op je profiel
- Ga naar Personaliseer Checkout
Koppel Mollie aan Wise
Mollie dashboard
Om betalingen via Mollie te laten verlopen, moeten er een aantal aanpassingen gedaan worden in de Wise Manager met gegevens uit het Mollie Dashboard. Binnen het Mollie Dashboard navigeer je naar de 'Developer' instellingen onder 'Meer'.
Hier kunnen de API-keys gevonden worden welke je nodig hebt om betalingen via Mollie in de Wise Manager in te stellen. Met de 'Test API-key' kunnen de online betaalmethodes getest worden binnen Mollie. Met de 'Live API-key' worden betalingen op productie aangemaakt, en zodra er betaald wordt zal dit (afhankelijk van instellingen binnen Mollie) uitbetaald worden op de rekening van bibliotheek.
Wise Manager
Om gebruik te kunnen maken van de online betaalmethode Payment Provider moet eerst de systeemoptie 'PSPCONF' aangezet worden. Deze wordt op systeemniveau gezet.
De online betaalmethode wordt namelijk in de systeemtabellen geconfigureerd en vervolgens in de instantie gekoppeld.
Met de API-keys kun je een nieuwe online betaalmethode aanmaken, welke jee voor Mollie kunt gebruiken.
In de Wise Manager navigeer je 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 'Mollie' en bij 'Payment Provider API key vul je de API key in die je uit het Mollie Dashboard hebt gehaald in de eerdere stappen. 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 Mollie kun je een instantie aansluiten op deze methode.
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 Mollie sturen zodra een betaling verwacht wordt. De wijziging gaat per direct in.
Na deze betaling komen ze weer terug op de Wisecat+ waar ze de status van hun betaling kunnen zien. Wanneer een betaling gedaan is bij Mollie wordt de administratie in Wise verwerkt en zal Mollie deze uitbetalen op basis van de opties die gedefinieerd staan bij Mollie.
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 Mollie?
In het Mollie dashboard 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.
Het kan voorkomen dat de status van een betaling niet gelijk doorgegeven kan worden, bijvoorbeeld door problemen in de verbinding met de server.
In het dashboard zie je rechts bij geschiedenis bijvoorbeeld 'Aanroepen webhook mislukt'.
In dit geval zal Mollie gedurende 26 uur proberen de webhook nogmaals aan te roepen. Hieronder een interval schema:
In de database worden de transacties ook gekenmerkt met een Mollie kenmerk.
Dagboekgebruik
Momenteel zullen er nog geen veranderingen plaatsvinden bij het dagboekgebruik. Betalingen die via Mollie plaatsvinden worden onder de noemer "iDEAL" geregistreerd: dagboekfunctie 'iDEAL' moet nog steeds worden gebruikt voor betalingen via Mollie. Binnen het dashboard van Mollie 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 Mollie. 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.