Mercado Pago Terminal-gateway
Met de Mercado Pago Terminal-gateway kun je vanuit WCPOS betalingen ter plaatse ontvangen op Mercado Pago Point Smart-terminals. Een betaling wordt gestart vanuit WooCommerce en op de terminal voltooid; de bevestiging van Mercado Pago wordt vervolgens bij de bestelling opgeslagen.
Mercado Pago Terminal for WooCommerce is een nieuwe extensie en 0.1.0 is de eerste release. Beschouw deze als bèta: begin in de modus Test met de virtuele sandboxterminal van Mercado Pago en voer een testbetaling uit voordat je echte betalingen accepteert.
Functies
Point Smart-hardware
Ontvang betalingen ter plaatse op Mercado Pago Point Smart 1- en 2-terminals
Actuele terminallijst
Terminals worden live uit je account opgehaald. In de instellingen kun je met één klik de actie Switch to PDV uitvoeren.
Betrouwbare voltooiing
Betalingen worden bevestigd door elke 2 seconden te controleren, via de Mercado Pago-webhook en met een achtergrondcontrole na 5 minuten, zelfs als de browser is gesloten
Terugbetalingen vanuit WooCommerce
Verzend volledige of gedeeltelijke terugbetalingen vanuit het WooCommerce-bestellingsscherm
Ingebouwde diagnostiek
Controleer de verbinding en webhookstatus in de instellingen en download een ondersteuningspakket om problemen op te lossen
Zo werkt het
De gateway gebruikt Mercado Pago's Orders API for Point in de cloud. Wanneer je een betaling start, wordt een Mercado Pago-bestelling aangemaakt voor het volledige WooCommerce-bestellingstotaal en naar de geselecteerde terminal gestuurd. De Mercado Pago-bestelling verloopt na 5 minuten.
De betaalpagina controleert Mercado Pago elke 2 seconden. De webhook en een achtergrondcontrole na 5 minuten kunnen een betaalde bestelling ook voltooien, zelfs als de browser is gesloten. De webhook is optioneel, maar aanbevolen; zonder Webhook secret worden meldingen wel verwerkt, maar niet op hun handtekening geverifieerd.
De terminal moet in de modus PDV (geïntegreerd) staan. Terminals worden geleverd in de modus STANDALONE. Schakel daarom in de gateway-instellingen over naar PDV en start de terminal opnieuw op voordat je betalingen accepteert.
Configuratie
Mercado Pago Terminal for WooCommerce installeren
Download het zipbestand van de plugin (niet het zipbestand met de GitHub-broncode) vanaf de GitHub-releasespagina. Upload het via Plugins > Add New > Upload Plugin en activeer het. WooCommerce moet hiervoor geïnstalleerd en actief zijn.
Je Mercado Pago-inloggegevens toevoegen
- Ga naar
WP Admin > WooCommerce > Settings > Paymentsen open Mercado Pago Terminal - Kies Mode: met
Testgebruik je de virtuele sandboxterminal; metLivegebruik je echte terminals - Plak het Access token (
APP_USR-…) van je toepassing uit Mercado Pago → Your integrations → Credentials
Een TEST--token in de modus Live stuurt betalingen naar de sandbox. Het instellingenscherm waarschuwt voor deze combinatie; plak je productietoken voordat je echte betalingen accepteert.
De webhook registreren
- Ga in Mercado Pago naar Your integrations → je toepassing → Webhooks
- Voeg de webhook-URL toe die op het gateway-instellingenscherm wordt weergegeven
- Selecteer de gebeurtenis Order (Mercado Pago) en sla op
- Kopieer de secret signature naar Webhook secret in WooCommerce
De webhook is optioneel. Betalingen worden ook zonder webhook voltooid doordat de status periodiek wordt gecontroleerd, maar als je het geheim instelt, kan de plugin webhookhandtekeningen verifiëren.
Je terminals instellen
- Sla het instellingenscherm op en laad het opnieuw. De vervolgkeuzelijst Default terminal en de tabel Terminals tonen de terminals in je account
- Klik bij een terminal die in de modus STANDALONE wordt weergegeven op Switch to PDV en start de terminal opnieuw op
- Kies een Default terminal
- (Optioneel) Beperk Enabled terminals tot de apparaten waaruit kassamedewerkers kunnen kiezen. Laat dit leeg om alle terminals toe te staan; de opgeslagen standaardterminal blijft beschikbaar, ook als deze hier niet is geselecteerd
- (Optioneel) Schakel Lock terminal selection in om altijd de standaardterminal te gebruiken en te voorkomen dat kassamedewerkers deze kunnen wijzigen. Hiervoor is een standaardterminal vereist
- Sla je instellingen op
Inschakelen in WCPOS
- Ga naar
WP Admin > POS > Settings > Checkout - Zoek de gateway Mercado Pago Terminal en schakel deze in voor de POS
- Sla je instellingen op
Het selectievakje Enable/Disable op het WooCommerce-instellingenscherm bepaalt alleen het afrekenen in de webwinkel. WCPOS gebruikt deze gateway zodra deze is geconfigureerd, ongeacht of het selectievakje is aangevinkt.
Instellingenoverzicht
| Instelling | Beschrijving |
|---|---|
| Enable/Disable | Schakelt de gateway in voor afrekenen in de webwinkel. Inschakelen voor de POS regel je via POS > Settings > Checkout |
| Title | Het label bij het afrekenen; standaard Mercado Pago Terminal |
| Description | De beschrijving bij het afrekenen; standaard Pay in person on a Mercado Pago Point terminal. |
| Mode | Test (standaard) gebruikt de virtuele sandboxterminal; Live gebruikt echte terminals met live inloggegevens |
| Access token | Het token van je toepassing in Mercado Pago → Your integrations → Credentials. Een opgeslagen token wordt niet opnieuw getoond; laat dit leeg om het te behouden |
| Webhook secret | De geheime handtekening uit de webhookinstellingen van Mercado Pago, gebruikt om meldingen te verifiëren |
| Default terminal | De terminal die standaard wordt gebruikt bij het afrekenen, live opgehaald uit je account. Als de lijst niet kan worden opgehaald, verschijnt er een tekstveld |
| Enabled terminals | Beperkt de terminals waaruit kassamedewerkers kunnen kiezen. Leeg betekent dat alle terminals zijn toegestaan; de standaardterminal is altijd beschikbaar. Verborgen als de lijst niet kan worden geladen |
| Lock terminal selection | Gebruikt altijd de standaardterminal, zodat kassamedewerkers deze niet kunnen wijzigen. Een standaardterminal is vereist |
| Checkout debug logs | Toont Show logs, Copy en Clear in het betaalvenster. Standaard uitgeschakeld; schakel dit in wanneer je logs verzamelt voor ondersteuning |
| Log level | Off, Errors only of Debug. In deze release standaard ingesteld op Debug; verzoeken en antwoorden worden vastgelegd zonder geheimen |
Onder de velden toont de tabel Mercado Pago Terminal diagnostics de API-controle (inclusief het aantal terminals en PDV's), de laatst geverifieerde webhook, de actieve omgeving, of inloggegevens zijn ingesteld, de standaardterminal, de webhook-URL en een link naar de betalingslogs.
Gebruik
Betalingen verwerken
- Producten toevoegen: voeg producten toe aan je winkelwagen in de POS
- Gateway selecteren: kies Mercado Pago Terminal als betaalmethode
- Terminal kiezen: selecteer een terminal of gebruik de standaardterminal als de selectie is vergrendeld
- Betaling starten: klik op Start Terminal Payment om het bestellingstotaal naar de terminal te sturen
- Betaling door de klant: volg de statusmeldingen —
Sending to terminal…→Waiting for terminal…→Customer is paying on the terminal…— terwijl de klant de betaling op de terminal voltooit - Automatische voltooiing: zodra Mercado Pago de betaling bevestigt, wordt de bestelling voltooid en gaat de POS naar de bon
Betalingsopties
- Start Terminal Payment: stuur een nieuw betalingsverzoek naar de geselecteerde terminal
- Cancel Terminal Payment: annuleer alleen voordat de terminal de betaling heeft opgehaald. Annuleer daarna op de terminal of wacht tot deze na 5 minuten verloopt
- De pagina opnieuw laden: hervat een betaling die al bezig is
Bonnen
De terminal drukt geen bon af. Gebruik de POS-bon nadat de betaling is voltooid.
Terugbetalingen
Open het terugbetalingsscherm van de WooCommerce-bestelling en kies Refund via Mercado Pago Terminal om een volledige of gedeeltelijke terugbetaling uit te voeren. Mercado Pago staat terugbetalingen toe tot 90 dagen na de betaling.
Sommige kaartverwerkers staan terugbetalingen alleen op de terminal toe. Voer in dat geval de terugbetaling uit op de terminal en registreer een handmatige terugbetaling in WooCommerce.
Logs en ondersteuningspakket
Je vindt logs in WooCommerce > Status > Logs onder de bron mercadopago-terminal. Het logniveau is in deze release standaard ingesteld op Debug. Verzoeken, antwoorden, webhooks en wijzigingen in de betalingsstatus worden vastgelegd; geheimen en kaartnummers worden onleesbaar gemaakt.
Klik op Download support bundle op het gateway-instellingenscherm om een .txt-bestand te downloaden en aan je ondersteuningsverzoek toe te voegen. Het bevat omgevingsgegevens, instellingen met afgeschermde inloggegevens, de terminallijst en bedrijfsmodi, betalingspogingen van de 10 meest recente bestellingen en de laatste 500 logregels; je kunt er geen betalingen mee uitvoeren.
Schakel Checkout debug logs in om Show logs, Copy en Clear aan het betaalvenster toe te voegen. Betalingsactiviteit wordt ongeacht deze instelling vastgelegd in de WooCommerce-logs.
Vereisten
Reikwijdte en beperkingen
- Op de terminal wordt het volledige bestellingstotaal in rekening gebracht. Slechts een deel van een bestelling op de terminal betalen wordt niet ondersteund
- Fooien worden niet ondersteund
- Bedragen worden verzonden met twee decimalen. Winkels die Chileense of Colombiaanse peso's gebruiken, moeten eerst een testbetaling uitvoeren
- De Blocks-afrekenfunctie van de webwinkel wordt niet ondersteund
- De plugin geeft nog geen HPOS-compatibiliteit aan
Problemen oplossen
Veelvoorkomende problemen
Toegangstoken geweigerd door Mercado Pago (HTTP 401)
- Het toegangstoken is ongeldig of verouderd
- Kopieer een nieuw token uit Your integrations → Credentials en sla het op bij Access token
Er worden geen terminals weergegeven
- Als er geen Point-terminals aan het account zijn gekoppeld, log je op de terminal in met dat Mercado Pago-account, schakel je over naar PDV en start je de terminal opnieuw op
- Als Default terminal een tekstveld is in plaats van een vervolgkeuzelijst, kon de lijst niet worden opgehaald. Controleer het token en de diagnostiek en laad vervolgens het instellingenscherm opnieuw
De terminal staat in de modus STANDALONE
- Voor geïntegreerde betalingen is de modus PDV vereist
- Klik op Switch to PDV in de tabel Terminals van het instellingenscherm en start de terminal vervolgens opnieuw op
De betaling staat al op de terminal
- De terminal heeft de betaling ontvangen, dus deze kan niet meer vanuit WooCommerce worden geannuleerd
- Annuleer de betaling op de terminal of wacht tot deze na 5 minuten verloopt. De betaalpagina blijft de status controleren
De webhook is nooit geverifieerd
- Controleer de webhook-URL en het geheim in Mercado Pago als de diagnostiek Last verified webhook: never toont
- Als Webhook secret ontbreekt, plak dan de secret signature van Mercado Pago. Betalingen worden nog steeds voltooid doordat de status periodiek wordt gecontroleerd, maar meldingen zonder het geheim worden niet op hun handtekening geverifieerd
De kaartverwerker heeft de terugbetaling geweigerd
- Sommige kaartverwerkers staan terugbetalingen alleen op de terminal toe; Mercado Pago beperkt terugbetalingen bovendien tot 90 dagen
- Voer de terugbetaling uit op de terminal en registreer een handmatige terugbetaling in WooCommerce
De betaling is verlopen op de terminal
- Mercado Pago-bestellingen verlopen na 5 minuten
- Start de betaling opnieuw
Hulp krijgen
- Voeg het ondersteuningspakket van het gateway-instellingenscherm toe aan je ondersteuningsverzoek
- Ga naar de GitHub-repository om problemen te melden
- Neem contact op met de ondersteuning van Mercado Pago voor vragen over je account en hardware