Voorbereiding
Voor u begint
- WordPress 6.5 of hoger, WooCommerce 7.0 of hoger en PHP 7.4 of hoger.
- De webshop rekent af in euro's. In een andere valuta toont WooCommerce de betaalmethode niet.
- U heeft beheerdersrechten in WordPress nodig om plugins te installeren.
- Een CCV- of Worldline-pinautomaat met een actieve Pin Vandaag-cloudverbinding, met het TMS-nummer en de bijbehorende API-key.
- Bij voorkeur een webshop op HTTPS: alleen dan stuurt de API de uitslag direct via de webhook terug.
Beveiliging: behandel de API-key als een wachtwoord. Deel hem niet in screenshots, openbare tickets of onbeveiligde e-mail. De plugin zet de API-key nooit in het logboek.
Stap 1
Installeer en activeer de plugin
- Download pin-vandaag-for-woocommerce-1.0.3.zip. Pak de zip niet uit.
- Ga in WordPress naar Plugins › Nieuwe plugin en klik bovenaan op Plugin uploaden.
- Kies het zip-bestand en klik op Nu installeren.
- Klik daarna op Plugin activeren. In de lijst staat nu Pin Vandaag voor WooCommerce.
Controle van de download: de SHA-256 van versie 1.0.3 is
a0ea544107722ce6ffb86493c7371a3fdfa9c6324c362e5a83413a81fe2666ce.Stap 2
Vul uw terminals en API-keys in
- Ga naar WooCommerce › Instellingen › Betalingen en open Pin Vandaag (pinautomaat). U kunt ook bij de plugin op Instellingen klikken.
- Zoek in PinPortal.nl per terminal het TMS-nummer en de API-key op, onder klantinstellingen › tabblad Overige › API Keys.
- Vul bij Terminals één terminal per regel in, gescheiden door een verticale streep. De naam is optioneel en ziet u terug bij de terminalkeuze.
- Laat Standaard terminal-ID leeg om de eerste terminal uit de lijst te gebruiken, of vul het TMS-nummer van een andere terminal in.
- Kies bij Terminalkeuze bij afrekenen of altijd de standaard terminal wordt gebruikt, of dat de klant of medewerker een terminal kiest.
- Klik op Wijzigingen opslaan en daarna op Test verbinding met alle terminals. Achter elke terminal hoort een vinkje te staan.
Algemene API-key: dit veld is alleen een reserve voor regels zonder eigen API-key, zoals het oude formaat
TMS-nummer|naam uit versie 1.0.0. Bij nieuwe installaties kunt u het leeg laten.Stap 3
Bepaal waar en hoe er betaald wordt
- Zet Pin Vandaag pinautomaat inschakelen aan.
- Kies bij Beschikbaar in waar betalen via de pinautomaat mogelijk is: Checkout van de shop (de klant betaalt zelf bij het afrekenen) en/of Beheeromgeving (een medewerker stuurt een bestelling naar de pin). Bestaande pintransacties blijven altijd zichtbaar bij de bestelling.
- Laat Testmodus aan zolang u test. In de checkout zien dan alleen ingelogde beheerders en winkelmanagers de betaalmethode.
- Pas eventueel de Titel en Omschrijving aan die de klant in de checkout ziet.
- Bij Verwerking stelt u in hoe vaak de status wordt opgevraagd (standaard 5 seconden), na hoeveel seconden een betaling wordt afgebroken (standaard 180), welke status een betaalde bestelling krijgt en of de pinbon wordt getoond of gemaild.
Afhalen aan de balie? Kies bij Status na geslaagde betaling voor Altijd voltooid, dan hoeft u de bestelling na het pinnen niet meer af te ronden.
Stap 4
Voer een testbetaling uit
- Log in als beheerder, zet een goedkoop product in de winkelwagen en kies bij het afrekenen Pinnen op de pinautomaat.
- Na het plaatsen van de bestelling ziet u een wachtpagina. Het bedrag verschijnt op de terminal.
- Rond de betaling af op de terminal. De wachtpagina gaat door naar de bedankpagina, met de pinbon als die aan staat.
- Controleer in WooCommerce dat de bestelling betaald is en dat in het blok Pin Vandaag pinautomaat de transactie en de pinbon staan.
- Test via de beheeromgeving ook Stuur … naar pin bij een openstaande bestelling, als u die optie gebruikt.
- Werkt alles, zet dan Testmodus uit. Vanaf dat moment zien klanten de betaalmethode.
Terugbetalen: een terugbetaling vanuit WooCommerce wordt op de terminal gestart. De klant moet daarvoor de pas aanbieden. Het resultaat verschijnt als notitie bij de bestelling.
Onderhoud
De plugin bijwerken
- Download de nieuwste zip van pinvandaag.nl/woocommerce. Het versienummer staat in de bestandsnaam.
- Ga naar Plugins › Nieuwe plugin › Plugin uploaden en upload de nieuwe zip.
- WordPress meldt dat de plugin al geïnstalleerd is en toont de huidige en de nieuwe versie. Kies de knop om de huidige versie te vervangen door de geüploade versie.
- Controleer onder Plugins dat het nieuwe versienummer bij Pin Vandaag voor WooCommerce staat.
Uw instellingen, terminals en API-keys blijven bij het bijwerken bewaard. U hoeft de plugin niet eerst te verwijderen.
Eenmalig bij de overstap van 1.0.2 of eerder naar 1.0.3: de plugin heeft vanaf 1.0.3 een nieuwe mapnaam. WordPress installeert de nieuwe versie daarom naast de oude en toont een melding dat de plugin twee keer geïnstalleerd is. Deactiveer en verwijder de oude Pin Vandaag voor WooCommerce met versie 1.0.2 of lager. Uw instellingen blijven bewaard.
Eerste controle
Problemen oplossen
De betaalmethode staat niet in de checkout
Controleer of de plugin is ingeschakeld, of Checkout van de shop aan staat, of er minstens één terminal is ingevuld en of de webshop in euro's afrekent. Staat de testmodus aan, dan ziet alleen een ingelogde beheerder de betaalmethode.
De verbindingstest geeft een kruisje
Controleer of TMS-nummer en API-key bij elkaar horen, of er geen spatie in staat en of de terminal online is. Sla de instellingen op voordat u opnieuw test.
Er verschijnt geen bedrag op de terminal
Start niet meerdere betalingen achter elkaar. Controleer de status in het blok bij de bestelling en breek een openstaande betaling eventueel af.
Er gaat iets mis en u wilt meer weten
Zet Debug-log aan en bekijk het logboek onder WooCommerce › Status › Logs, bron pinvandaag. Zet het daarna weer uit.