Square Terminal-betaalgateway
De kassa stuurt het bedrag naar een Square Terminal, de klant betaalt op de Terminal en de verkoop gaat automatisch verder zodra Square de betaling goedkeurt. Deze pagina bestaat uit twee delen: een betaling ontvangen aan de kassa en de extensie instellen in WP Admin.
Square Terminal vereist WCPOS Pro 2.0 of nieuwer.
Een betaling ontvangen
- De kassa is online en de Terminal staat aan. Als de tegel Square Terminal ontbreekt, vraag je de beheerder van WP Admin om de extensie in te stellen.
- Als Kassa openen en sluiten is ingeschakeld, moet de kassa geopend zijn. De kassa registreert geen betalingen zolang deze gesloten is. Een kaartbetaling die al op de Terminal is uitgevoerd, zou dan moeten worden terugbetaald. Zie De kassa openen.
- Vul de winkelwagen en druk op Afrekenen.
- Tik op het tabblad Betalingen op de tegel Square Terminal.
- Controleer de terminalregel met Terminal: en de naam van de Terminal. Zijn er meerdere Terminals, druk dan op Wijzigen en tik op die bij jouw kassa. Zolang je er geen hebt gekozen, staat er Kies een terminal in het paneel.
- Laat het bedrag op het openstaande saldo staan of voer een lager bedrag in om een deel per kaart te ontvangen. Zie Gesplitste betalingen.
- Druk op Stuur $45.00 naar Square Terminal (de knop toont jouw bedrag). In het paneel verschijnt Terminal wordt gestart…, gevolgd door Wachten op de klant bij de terminal.
- De klant houdt de kaart tegen de Terminal, steekt de kaart erin of haalt deze door de kaartlezer.
- Wanneer Square de betaling goedkeurt, doorloopt de betaling de stappen Goedgekeurd en Geïncasseerd. Als daarmee het saldo is voldaan, wordt de verkoop afgerond en verschijnt de bon. Zo niet, ontvang dan de rest op dezelfde of een andere manier.
Tijdens de betaling toont het paneel:
- OP DE TERMINAL en het verstuurde bedrag.
- Eén statusregel, zoals Wachten op de klant bij de terminal.
- De betaalmethode en de naam van de Terminal.
- Vier stappen: Verstuurd, Op terminal, Goedgekeurd, Geïncasseerd.
- Details: elke stap die Square heeft gemeld, met het tijdstip en de ID's van Kaartlezer, Actie en Betaling. Met Kopiëren (Delen op sommige apparaten) geef je het logboek door aan degene die je helpt.
Betaalstatusmeldingen en wat je moet doen
- Goedgekeurd, gevolgd door Geïncasseerd: het geld is ontvangen. Als daarmee het saldo is voldaan, verschijnt de bon. Zo niet, ontvang dan de rest.
- Betaling geannuleerd: de Terminal heeft je annulering bevestigd. Druk op Opnieuw proberen of Kies een andere manier.
- Time-out — betaling geannuleerd: er heeft niemand binnen 5 minuten betaald. Druk op Opnieuw proberen of Kies een andere manier.
- Annuleren — wachten op bevestiging van de terminal: de Terminal heeft nog niet op je annulering gereageerd. Wacht of druk op Deze betaling vrijgeven. Zie Een betaling stoppen.
- Betaling vrijgegeven: de bestelling kan op een andere manier worden betaald, maar het bedrag kan al via de Terminal van de kaart zijn afgeschreven. Kijk eerst op het scherm van de Terminal.
Een betaling stoppen
Met Annuleren op terminal vraag je Square de betaling op de Terminal te annuleren. In het paneel staat Annuleren… en vervolgens Betaling geannuleerd zodra de Terminal dit bevestigt. Druk op Opnieuw proberen om de betaling opnieuw te versturen of op Kies een andere manier om terug te gaan naar de tegels.
Als de Terminal niet bevestigt (omdat deze uitstaat, geen bereik heeft of vastloopt), toont het paneel Annuleren — wachten op bevestiging van de terminal en de optie Deze betaling vrijgeven, met de tekst Geeft de bestelling vrij om op een andere manier te betalen. De winkel blijft de terminal controleren.
Vrijgeven annuleert de betaling bij Square niet. De winkel blijft deze op de achtergrond controleren, ongeveer elke 10 minuten. Kijk op het scherm van de Terminal voordat je het bedrag op een andere manier ontvangt. Als het scherm aangeeft dat de betaling is gelukt, ontvang het bedrag dan niet nogmaals: de winkel registreert die betaling bij een van de volgende controles bij de bestelling. Zie Als er iets misgaat.
Deze betaling vrijgeven geeft de bestelling vrij; dit bevestigt niet dat de betaling is geannuleerd. In het paneel staat Betaling vrijgegeven. Controleer de Terminal voordat je op Kies een andere manier drukt: als het scherm aangeeft dat de betaling is gelukt, voer dan niet opnieuw een betaling uit en wacht tot de bestelling is bijgewerkt. Als het scherm aangeeft dat de betaling is geannuleerd, ga je met Kies een andere manier terug naar de tegels om het bedrag op een andere manier te ontvangen. Als je het niet kunt vaststellen (de Terminal staat uit, heeft geen bereik of toont niets), is het resultaat onbekend: als je het bedrag op een andere manier ontvangt en de winkel later bij een controle de Terminal-betaling vindt, registreert de winkel ook die betaling bij de bestelling. Betaal dan een van de twee betalingen terug vanuit de bestelling. Zie Terugbetalingen.
Als niemand binnen 5 minuten op de Terminal betaalt, wordt de betaling geannuleerd en toont het paneel Time-out — betaling geannuleerd.
Als er iets misgaat
Geen terminals ingesteld voor Square Terminal. Er is nog geen Terminal aan de extensie gekoppeld. Vraag de beheerder van WP Admin om er een te koppelen.
In gebruik door bestelling #… Op die Terminal wordt een betaling voor een andere bestelling uitgevoerd. Rond die betaling eerst af of annuleer deze, of kies een andere Terminal.
Betaling mislukt met een reden. Druk op Opnieuw proberen of Kies een andere manier. Onder Details zie je wat Square heeft gemeld.
Annuleren — wachten op bevestiging van de terminal. De Terminal heeft nog niet op de annulering gereageerd. Wacht of druk op Deze betaling vrijgeven. Zie Een betaling stoppen.
De betaling op de Terminal is gelukt, maar de kassa wacht nog. De kassa blijft tijdens het wachten navraag doen bij Square en gaat verder zodra Square antwoordt. Met een webhook krijgt de winkel sneller bericht. Als de kassa niet meer wacht (omdat deze is gesloten of je de betaling vrijgeeft), registreert de achtergrondcontrole van de winkel ongeveer elke 10 minuten betalingen die de kassa heeft gemist. Ontvang het bedrag tijdens het wachten niet op een andere manier: kijk eerst op het scherm van de Terminal.
De tegel ontbreekt. De betaalgateway is niet ingeschakeld voor de POS. Zie Inschakelen voor de POS.
Problemen bij het instellen, voor de beheerder van WP Admin
De Terminal staat niet in de lijst
De Terminal moet aan deze extensie zijn gekoppeld: gebruik Apparaatcode aanmaken en voer de code in op de Terminal. Een Terminal die via het Square Dashboard of de Square-app is gekoppeld, verschijnt pas nadat je deze hier hebt gekoppeld. Als de Terminal bij Zoeken naar kaartlezers onder Andere apparaten die Square op deze locatie ziet staat, is deze wel aanwezig maar hoort deze bij een andere applicatie. Controleer ook of de Locatie-ID overeenkomt met de locatie waarbij de Terminal is aangemeld.
De Terminal kan niet worden gekoppeld
De code is 5 minuten geldig: maak een nieuwe aan. De Terminal moet online zijn en afgemeld zijn bij de Square-app of elke andere integratie, omdat de code de Terminal aanmeldt bij het account en de Locatie-ID die hier zijn ingesteld. De Omgeving moet overeenkomen met dat account.
Instellingen valideren mislukt
Als je verbinding hebt gemaakt, controleer dan of de regel Square-account nog steeds Verbonden met Square toont. Gebruik je een eigen toegangstoken, controleer dan of dit voor de geselecteerde Omgeving is: een sandboxtoken werkt niet in Live en andersom. Controleer of de Locatie-ID bij dat account hoort.
Opnieuw verbinden met Square vereist
Autorisaties van Square worden automatisch vernieuwd. Als een vernieuwing niet kan worden voltooid, beëindigt de extensie de autorisatie en vraagt deze je opnieuw verbinding te maken. Druk op Opnieuw verbinden met Square; verder hoef je niets te wijzigen.
Waar je de logboeken vindt
WooCommerce > Status > Logs, bron square-terminal-for-woocommerce. Belangrijke stappen worden ook in de bestelnotities vastgelegd, met Square Terminal: aan het begin.
Instellen
Dit deel is bedoeld voor de beheerder van WP Admin van de winkel. Je winkel stuurt elke betaling naar Square en Square stuurt deze door naar de gekoppelde Terminal. De kassa heeft dus een verbinding met de winkel nodig. Voer deze vier stappen in volgorde uit:
- Installeer de extensie vanuit de extensiecatalogus.
- Maak verbinding met Square en kies de locatie.
- Koppel je Terminal of gebruik de testapparaten van Square in de sandbox.
- Schakel de betaalgateway in voor de POS.
De extensie installeren
Open WP Admin > POS > Settings > Extensions, zoek Square Terminal en klik op Installeren en vervolgens op Activeren. Zie Een extensie installeren.
Zonder de catalogus download je het zipbestand van de plugin (niet het zipbestand met de broncode) van de releasepagina op GitHub en upload je het via Plugins > Add Plugin, gevolgd door Plugin uploaden. Zonder WCPOS Pro 2.0 doet de extensie niets en meldt deze dat WCPOS Pro vereist is.
Verbinding maken met Square
- Ga naar
WP Admin > WooCommerce > Settings > Paymentsen open Square Terminal. - Kies onder Square-account de Omgeving: Testmodus (sandbox) (de standaardinstelling) om te testen of Live voor echte betalingen. Kies dit voordat je verbinding maakt: een verbinding geldt voor slechts één omgeving.
- Klik op Verbinden met Square en geef de toestemmingen waar Square om vraagt.
- Kies de Locatie-ID: de Square-locatie waarvoor de Terminal betalingen ontvangt.
- Laat onder Welk Square-apparaat gebruik je? de optie Square Terminal staan.
Gebruik je de officiële WooCommerce Square-plugin al? Omgeving en Locatie-ID worden daaruit vooraf ingevuld. Sla op om ze toe te passen. De twee plugins delen geen toegangsgegevens, dus je moet hier nog steeds verbinding maken.
Gebruik je liever je eigen toegangstoken? Open Geavanceerde instellingen en plak een Sandbox-toegangstoken of Productie-toegangstoken in plaats van verbinding te maken.
Je Terminal koppelen
Klik onder Terminal op Apparaatcode aanmaken en voer de code binnen 5 minuten in op de Terminal. Klik daarna op Zoeken naar kaartlezers. De volledige stappen, de inhoud van de lijst en de sandbox-testapparaten vind je onder Gekoppelde Terminals en testapparaten.
Inschakelen voor de POS
Ga naar WP Admin > POS > Settings > Checkout, zoek Square Terminal en zet Ingeschakeld aan. Zie Een betaalgateway inschakelen.
Square Terminal is alleen bedoeld voor medewerkers aan de kassa en wordt nooit aangeboden bij het afrekenen in je webshop. De schakelaar Ingeschakeld in de lijst Betalingen van WooCommerce heeft hier geen invloed op.
Gekoppelde Terminals en testapparaten
Een Terminal moet aan deze extensie zijn gekoppeld voordat een kassamedewerker deze kan kiezen. Bij het koppelen wordt een Square-apparaatcode aangemaakt. Alleen daarmee kan de extensie de Terminal bereiken.
- Klik onder Terminal op Apparaatcode aanmaken. Op het scherm staat Koppelcode: … — voer deze binnen 5 minuten in op de Terminal.
- Open op de Terminal het aanmeldscherm voor apparaatcodes en voer de code in. Als de Terminal is aangemeld bij de Square-app of een andere integratie, meld deze daar dan eerst af: het scherm voor apparaatcodes is niet bereikbaar zolang de Terminal ergens anders in gebruik is.
- Klik op Zoeken naar kaartlezers. De Terminal verschijnt nu onder Gekoppeld aan deze plugin — te selecteren bij het afrekenen.
Zoeken naar kaartlezers toont de apparaten die Square ziet, in twee groepen:
- Gekoppeld aan deze plugin — te selecteren bij het afrekenen: de Terminals die kassamedewerkers kunnen kiezen.
- Andere apparaten die Square op deze locatie ziet: Terminals die via een andere applicatie zijn ingesteld. Je kunt ze hier pas kiezen nadat je ze met een nieuwe code hebt gekoppeld.
Instellingen valideren vraagt Square of je verbinding (of toegangstoken) en de locatie werken. Als dat zo is, verschijnt Square-toegangsgegevens en locatie geverifieerd.
Square toont alleen Terminals die met een apparaatcode zijn gekoppeld. Een Terminal waarop de Square-app draait, verschijnt pas wanneer er een apparaatcode op is ingevoerd.
Testmodus: testapparaten van Square in plaats van een Terminal
In Testmodus (sandbox) zijn er geen apparaatcodes en hoef je niets te koppelen. De kassa toont de testapparaten van Square op de plek waar anders een gekoppelde Terminal zou staan. Elk apparaat simuleert één resultaat, zonder hardware:
| Testapparaat | Wat het simuleert |
|---|---|
| Sandbox: Geslaagd (breng $25 of minder in rekening) | Een goedgekeurde kaartbetaling. Houd het bedrag op $25 of minder. |
| Sandbox: Geslaagd met 20% fooi | Een betaling met een fooi. Square ontvangt hier geen fooien, dus de betaling mislukt met de melding: De terminal heeft een ander bedrag bevestigd. |
| Sandbox: Klant annuleert op terminal | De klant annuleert op de Terminal. |
| Sandbox: Onmiddellijke time-out | Er betaalt niemand en de betaling krijgt direct een time-out. |
| Sandbox: Offline terminal (blijft in behandeling) | Een Terminal die nooit antwoordt. Gebruik deze om Een betaling stoppen zonder hardware uit te proberen. |
Webhooks
Een webhook is optioneel. Hiermee kan Square je winkel direct laten weten dat een betaling verandert, zodat de kassa sneller verdergaat. Zonder webhook vraagt de kassa tijdens het wachten het resultaat op bij Square. De achtergrondcontrole van de winkel registreert ongeveer elke 10 minuten de resultaten die de kassa heeft gemist. In beide gevallen registreert de winkel een betaling pas als Square de betaling zelf bevestigt; alleen een afrekenproces dat Square als afgerond markeert, is niet genoeg.
Een webhook toevoegen
Dit werkt alleen als je de extensie onder Geavanceerde instellingen met je eigen toegangstoken hebt ingesteld. Als je Verbinden met Square hebt gebruikt, heb je de WCPOS-applicatie geautoriseerd, niet een eigen applicatie. Je hebt dan dus geen applicatie waaraan je een abonnement kunt toevoegen en geen ondertekeningssleutel om te kopiëren. Betalingen worden nog steeds bevestigd via de controles van de kassa zelf en de achtergrondcontrole.
Gebruik met je eigen toegangstoken je applicatie in het Square Developer Dashboard:
- Klik in het instellingenscherm in de regel Webhooks onder Terminal op Kopiëren om de webhook-URL te kopiëren.
- Open je applicatie in het Square Developer Dashboard en ga naar Webhooks.
- Voeg een abonnement toe voor de gebeurtenis
terminal.checkout.updated, met die URL als meldings-URL. - Kopieer de Ondertekeningssleutel van het abonnement naar Webhook-ondertekeningssleutel onder Geavanceerde instellingen en sla op.
Zodra er een ondertekende webhook is ontvangen, staat in de regel Webhooks de melding … geleden geverifieerd.
Square ondertekent elke webhook met de opgegeven meldings-URL. Als de URL in Square ook maar één teken verschilt van die in het instellingenscherm, mislukt elke aflevering. Gebruik Kopiëren in plaats van de URL over te typen.
Upgraden vanaf versie 0.x
Versie 1.0.0 toont een nieuwe webhook-URL. Als je al een abonnement hebt, wijzig dan de meldings-URL daarvan in Square naar de URL die nu in het instellingenscherm staat. Door het bestaande abonnement te wijzigen, behoud je de ondertekeningssleutel. Webhook-URL overschrijven verandert deze URL niet; die instelling geldt alleen voor de eigen betaalpagina van de extensie. Als het openbare adres van je site afwijkt van het getoonde adres, kunnen de webhooks niet worden geverifieerd. Betalingen worden nog steeds bevestigd via de controles van de kassa zelf en de achtergrondcontrole.
Webhook-abonnementen van Square horen bij een Square-applicatie en kunnen niet met het toegangstoken van een verkoper worden toegevoegd. De extensie kan het abonnement dus niet voor je toevoegen.
Als webhooks niet meer worden geverifieerd
In de regel Webhooks staat Nog niet geverifieerd totdat er een webhook binnenkomt die met de huidige instellingen kan worden geverifieerd.
Er zijn betalingen uitgevoerd, maar er staat nog steeds Nog niet geverifieerd
Controleer het volgende:
- Webhook-ondertekeningssleutel komt overeen met de sleutel van het abonnement in Square.
- De meldings-URL in Square komt exact overeen met die in het instellingenscherm.
- Het abonnement bevat
terminal.checkout.updated. - Je site is via HTTPS bereikbaar vanaf het internet. Het dashboard van Square toont elke afleverpoging.
Als je de omgeving, de webhook-URL of de ondertekeningssleutel wijzigt, wordt de regel teruggezet totdat de volgende webhook binnenkomt. Dat is bewust zo: een webhook die met de oude instellingen is geverifieerd, zegt niets over de nieuwe instellingen.
Overzicht van instellingen
Onder WP Admin > WooCommerce > Settings > Payments > Square Terminal, in de volgorde waarin je de configuratie uitvoert. Open een groep om de instellingen ervan te bekijken.
Square-account
- Omgeving: Testmodus (sandbox) (standaard) of Live. Een verbinding geldt voor één omgeving.
- Verbinden met Square: autoriseert deze site bij Square. Daarna verschijnen Verbonden met Square, de verkoper en Verbinding verbreken.
- Locatie-ID: de Square-locatie waarvoor de Terminal betalingen ontvangt.
- Welk Square-apparaat gebruik je?: Square Terminal (deze pagina, de standaardinstelling) of Square Reader.
Terminal
- Apparaatcode aanmaken, Zoeken naar kaartlezers, Instellingen valideren: een Terminal koppelen, weergeven welke apparaten Square ziet en de configuratie controleren. Zie Gekoppelde Terminals en testapparaten.
- Webhooks: of er een ondertekende webhook is ontvangen en de URL die je met Kopiëren kunt overnemen. Zie Webhooks.
Gedrag bij het afrekenen
- Bonscherm overslaan: de Terminal keert terug naar de ruststand zonder het eigen bonscherm te tonen.
- Handtekening vragen: vraagt de klant om op de Terminal te tekenen, als de betaling dit ondersteunt.
- Debuglogboeken voor afrekenen: een logboekpaneel op de eigen betaalpagina van de extensie waarvan je de inhoud kunt kopiëren. Bedoeld voor ondersteuning; je kunt dit gerust uit laten staan.
Geavanceerde instellingen
- Sandbox-toegangstoken, Productie-toegangstoken: alleen nodig als je hierboven geen verbinding maakt.
- Webhook-ondertekeningssleutel: optioneel. Hiermee kan de winkel webhooks verifiëren; betalingen worden ook zonder deze sleutel bevestigd.
- Webhook-URL overschrijven: alleen voor de eigen betaalpagina van de extensie. Zie Webhooks.
Geavanceerde instellingen is ook in het instellingenscherm standaard ingeklapt.
Square Reader in plaats van een Terminal
Stel Welk Square-apparaat gebruik je? in op Square Reader om de betaling te ontvangen in de Square Point of Sale-app, met een Square Reader die aan die telefoon of tablet is gekoppeld. Het instellingenscherm toont dan een checklist met vijf stappen: Je Square Reader instellen.
De vijf stappen om Square Reader in te stellen
- Verbind je Square-account.
- Kies je locatie.
- Registreer je winkel bij Square: plak je Applicatie-ID.
- Geef Square het terugkeeradres van je winkel.
- Stel de telefoon of tablet in.
Aan de kassa verloopt de betaling via de eigen betaalpagina van de extensie, op het tabblad Legacy: druk op Square Point of Sale openen en rond de betaling af in de Square-app. Dit werkt alleen:
- in Live, niet in de testmodus;
- op een Android- of iOS-telefoon of -tablet waarop de Square Point of Sale-app is geïnstalleerd. Op andere apparaten is de knop uitgeschakeld en wordt de reden aangegeven.
Terugbetalingen
Betaal een Square Terminal-betaling terug vanuit de bestelling. Het geld gaat dan via Square terug naar de kaart van de klant. Gedeeltelijke terugbetalingen zijn ook mogelijk. Zie Terugbetalingen.
Een betaling die via de eigen betaalpagina van de extensie is ontvangen, bijvoorbeeld met een versie vóór 1.0.0, betaal je terug vanuit het Square Dashboard.
Vereisten
Gerelateerde documentatie
- Een betaling ontvangen: op een kaartlezer
- Het betaalpaneel
- Een betaling annuleren
- Square Terminal API-documentatie, voor vragen over hardware en de API
- Meld een probleem met de extensie op GitHub. De ondersteuning van Square behandelt vragen over accounts en hardware.