Technische handleiding
# Inleiding
Deze technische handleiding is geschreven voor ontwikkelaars. De Mollie Plus plugin is te krijgen via de Craft Plugin Store (opens new window).
Deze handleiding is zorgvuldig samengesteld door WHITE Digital Agency. Het is niet toegestaan deze Craft handleiding te verspreiden zonder ons hiervoor vooraf om toestemming te vragen. Eventueel genoemde merken en beeldmerken zijn eigendom van Pixel & Tonic (opens new window) en Mollie (opens new window).
Aanvullingen of opmerkingen? Laat het ons weten! Samen kunnen we anderen helpen bij een geweldige Craft ervaring.
Er is ook een handleiding voor Craft CMS en Craft Commerce beschikbaar.
# Vereisten
- Deze plugin vereist Craft CMS 3.1.5 of later.
- Deze plugin vereist Craft Commerce versie 2.0 of later.
- Een geactiveerd Mollie account is vereist. Nog geen account? Creëer een Mollie account (opens new window).
- De Craft website moet publiekelijk toegankelijk zijn.
- Om de plugin te kunnen configureren moet je rechten hebben om instellingen te wijzigen in Craft (wijzigingen toestaan) (opens new window), de user moet Admin zijn in Craft.
- Deze plugin is compatible met Composer 2.0.
# Installatie
Volg de onderstaande stappen om de Mollie Plus plugin voor Craft CMS te installeren:
- Open je terminal en ga naar je Craft project:
cd /path/to/project - Laad de plugin met Composer:
composer require white-nl/commerce-mollie-plus - Installeer de plugin via CLI:
./craft plugin/install commerce-mollie-plus
Je kunt de Mollie Plus plugin ook installeren via de Plugin Store in het Craft Control Panel. Ga naar Settings → Plugins en klik op de Commerce Mollie Plus “Install” knop.
# Plugins vergeleken
# Mollie Plus versus Mollie voor Commerce
Mollie Plus is een kant-en-klare vervanger* voor de Commerce plugin Mollie van Pixel & Tonic. We adviseren je om deze te vervangen door Mollie Plus. Het zal een naadloze overgang zijn, omdat ze op dezelfde manier werken.
*De plugin draait volledig onafhankelijk van de Mollie plugin. Je kunt zelfs beide plugins tegelijkertijd uitvoeren.
# Gateway instellen
# Mollie payment gateway toevoegen
- Ga naar Commerce → Systeem instellingen → Gateways.
- Creëer een nieuwe gateway, stel Mollie Plus in als gatewaytype.
- Stel een geldige API Key in om de plugin te laten werken. Je kunt deze verkrijgen in het Mollie control panel (opens new window).
De API Key instelling kan worden ingesteld op omgevingsvariabelen. Zie Environmental Configuration (opens new window) in de Craft documentatie (Engels) voor meer informatie hierover.
# Bestelstatus om automatisch betalingen vast te leggen
Wanneer de status van een Craft bestelling verandert in één van de gedefinieerde statussen, worden alle nog niet vastgelegde Mollie-transacties die eraan gekoppeld zijn automatisch gepakt.
# Klarna toevoegen
Er zijn geen extra plugin instellingen vereist om Klarna aan te bieden in je checkout. Maar zorg er wel voor dat je via het Mollie Control panel (opens new window) een aanvraag hebt ingediend voor de Klarna betaalmethoden.
Mollie Plus ondersteunt drie betaalmethoden van Klarna:
- Klarna Pay Later
- Klarna Slice it
- Klarna Pay Now
# Frontend
Bij de installatie van de plugin wordt een voorbeeldformulier voor het selecteren van betaalmethoden geleverd, maar dit kan worden aangepast aan je eigen wensen. Je kunt aangepaste styling toevoegen, pictogrammen weergeven en aangepaste code uitvoeren.
# Probleemoplossing
Alle reacties van Mollie worden vastgelegd in de transactielijst van de bestelling, vergelijkbaar met de originele Mollie-plugin.
# Support
# Beperkte ondersteuning voor het terugbetalen van Klarna-transacties
Het terugbetalen van betalingen via Craft werkt via de Mollie Payment API, terwijl transacties worden aangemaakt via de Orders API. Het terugbetalen van willekeurige bedragen via het Craft Control Panel voor Klarna-transacties kan leiden tot onverwacht gedrag. We raden aan het Mollie Controle Panel te gebruiken om specifieke regels van een bestelling terug te betalen.
# Geen ondersteuning voor vouchers
Mollie voucher diensten worden niet ondersteund door deze plugin.