Mercado Pago Terminal-betaalgateway
Mercado Pago Terminal stuurt een verkoop van de kassa naar een Mercado Pago Point-terminal. De klant betaalt op de terminal en de kassa registreert de betaling zodra Mercado Pago deze bevestigt.
Deze pagina begint bij de kassa. Winkelbeheerders vinden bij Mercado Pago Terminal instellen informatie over het toegangstoken, de webhook, de terminals en hoe je controleert of alles werkt.
Mercado Pago Terminal vereist WCPOS Pro 2.0 of hoger en versie 1.0 of hoger van de extensie.
Versie 1.0 is nog niet getest met een echte Point-terminal of een Mercado Pago-account. Voer voordat je de kaart van een klant gebruikt een kleine betaling uit met je eigen kaart en betaal die terug. Versie 1.0 is getest met een vervanger voor Mercado Pago, gebouwd op basis van de documentatie van Mercado Pago. Met versie 0.1 zijn op een live account en een echte Point Smart de terminals opgehaald, is er een terminal naar de PDV-modus omgeschakeld en is een betaling aangemaakt en geannuleerd. Met geen van beide versies zijn nog getest: een betaalde kaartbetaling, een weigering, annuleren op de terminal, meldingen van Mercado Pago, terugbetalingen en de sandbox van Mercado Pago.Wat wel en niet is getest
Een kaartbetaling ontvangen
Als De kassa openen en sluiten is ingeschakeld, registreert de kassa geen betaling wanneer de kassa gesloten is. Een kaartbetaling die je al hebt geïnd, moet dan worden terugbetaald. Zie Kassa's voor deze instelling.
- Druk in de winkelwagen op Afrekenen en tik op de tegel Mercado Pago Terminal op het tabblad Betalingen. Je winkel kan deze een andere naam hebben gegeven.
- Kijk boven het toetsenblok. Zie je Een terminal kiezen, tik dan op de terminal bij je kassa. Zie je Terminal: met een naam, dan gebruikt deze kassa die terminal; druk op Wijzigen om een andere te kiezen. De kassa onthoudt je keuze.
- Typ het bedrag om een deel van het verschuldigde bedrag met de kaart te betalen. De rest blijft openstaan voor een volgende betaling. Met Volledig bedrag wordt het hele bedrag afgerekend.
- Druk op … naar Mercado Pago Terminal sturen. De kassa toont Wachten op de klant bij de terminal.
- De klant betaalt op de terminal. Zodra het bedrag is geïnd en er niets meer openstaat, verschijnt de bon. Als er nog een bedrag openstaat, reken je dat af met een andere tegel.
Wat de stappen op de kassa betekenen
Tijdens de betaling licht de kassa achtereenvolgens Verzonden, Op terminal en Geïnd op. Geïnd betekent dat het geld is afgeschreven. Goedgekeurd blijft donker bij Mercado Pago, dat het geld in één stap int.
De terminal drukt geen ticket af. Druk de POS-bon af of e-mail deze zoals gebruikelijk; zie Bonnen bij het afrekenen. De terminal biedt geen fooioptie.
Een betaling annuleren
Druk op de kassa op Annuleren op terminal. Dit werkt alleen totdat de betaling op het scherm van de terminal verschijnt. Zodra de klant deze kan zien, kan de kassa de betaling niet meer terugdraaien:
- Als de klant het bedrag al kan zien, annuleer de betaling dan op de Mercado Pago-terminal zelf of vraag de klant niet te betalen.
- Wacht op de kassa. Deze kan tijdens de controle Annuleren — wachten op bevestiging van de terminal blijven tonen. De klant kan nog betalen totdat de terminal annuleert. Reken de betaling dus nog niet op een andere manier af.
- De kassa toont Betaling geannuleerd zodra de terminal annuleert. Als niemand annuleert, verwijdert Mercado Pago de betaling na 5 minuten en toont de kassa Betaling mislukt: time-out op de terminal.
Als de kassa in plaats daarvan Deze betaling vrijgeven aanbiedt, druk hier dan pas op nadat een manager Mercado Pago heeft gecontroleerd: zie De kassa biedt Deze betaling vrijgeven aan onder Andere meldingen.
Als er iets misgaat
Wanneer de klant mogelijk heeft betaald
In deze gevallen kan het bedrag al van de kaart zijn afgeschreven. Een manager controleert eerst je Mercado Pago-account; daar staat de betaling vermeld als Bestelling # gevolgd door het bestelnummer.
Het bedrag is van de kaart afgeschreven, maar de bestelling is niet afgerond. Mercado Pago heeft het geld geïnd, maar de kassa kon de bestelling niet afronden. Breng het bedrag niet opnieuw in rekening. Laad de app opnieuw; de kassa probeert de verkoop dan alsnog af te ronden. Als de bestelling nog openstaat, rondt een manager deze af. Zie Bedrag afgeschreven, bestelling niet afgerond.
Betaling mislukt: de terminal heeft een ander bedrag bevestigd. De terminal heeft een ander bedrag geïnd dan de kassa heeft verstuurd. De kassa heeft de betaling daarom niet geregistreerd, maar het bedrag kan wel van de kaart zijn afgeschreven. Vraag een manager de betaling in Mercado Pago op te zoeken en met de bestelling te vergelijken.
De kassa is gesloten of heeft tijdens een betaling de verbinding verloren. Verstuur de betaling niet opnieuw vanaf een andere kassa. Als je beheerder de webhook heeft ingesteld, registreert je winkel de betaling ook wanneer de kassa gesloten is. Open de bestelling. Staat deze nog als onbetaald, dan controleert een manager Mercado Pago voordat je opnieuw afrekent.
Andere meldingen
Betaling mislukt: kaart geweigerd
Druk op Opnieuw proberen om de betaling opnieuw naar de terminal te sturen, of op Andere betaalmethode kiezen om met een andere tegel te betalen.
Betaling mislukt: gevolgd door een code
Mercado Pago heeft de betaling geweigerd en een reden gegeven die de kassa niet vertaalt. Daarom toont de kassa de code van Mercado Pago. Druk op Opnieuw proberen of Andere betaalmethode kiezen. Blijft dezelfde code terugkomen, stuur dan de supportbundel mee met het bestelnummer.
De terminal is nog bezig met een eerdere bestelling
De terminal heeft een andere betaling openstaan. Rond deze af of annuleer deze op de terminal en druk daarna op Opnieuw proberen.
Betaling mislukt: time-out op de terminal
Niemand heeft binnen 5 minuten betaald. Controleer de terminal en druk daarna op Opnieuw proberen.
De kassa biedt Deze betaling vrijgeven aan
Mercado Pago heeft de annulering geaccepteerd, maar nog niet bevestigd. Vrijgegeven betekent niet geannuleerd: druk hier pas op nadat een manager je Mercado Pago-account heeft gecontroleerd en heeft vastgesteld dat er geen goedgekeurde betaling voor de bestelling is. Daarna kan de bestelling op een andere manier worden betaald.
De tegel Mercado Pago Terminal is grijs of ontbreekt
Onder de tegels geeft de kassa de reden weer. Zie Wanneer een tegel niet kan worden gebruikt voor alle mogelijke redenen.
- In gebruik voor bestelling #… — de terminal is bezig met een betaling voor een andere bestelling. Rond die betaling af of annuleer deze, of druk op Wijzigen en kies een andere terminal.
- Verbinding vereist — de kassa is offline. Een terminalbetaling verloopt via je winkel. Gebruik daarom een andere betaalmethode of wacht tot de verbinding is hersteld.
- Geen terminals ingesteld voor Mercado Pago Terminal — geen van je terminals staat in de modus PDV. Een manager schakelt ze om naar PDV.
- Helemaal geen tegel — de gateway heeft geen toegangstoken of is niet ingeschakeld in WCPOS. Een manager controleert de configuratie.
Een Mercado Pago-betaling terugbetalen
Een terugbetaling gaat via Mercado Pago terug naar de kaart van de klant, voor het volledige bedrag of een deel ervan.
- Open in de POS de terugbetaling van de bestelling. Zie Terugbetalingen.
- Kies Terugbetalen via Mercado Pago Terminal en druk op Terugbetaling verwerken.
- Je winkel vraagt Mercado Pago om de terugbetaling en voegt het resultaat toe aan de bestelnotities.
Een terugbetaling in WP Admin via de WooCommerce-knop … terugbetalen via Mercado Pago Terminal werkt hetzelfde. Ook verkopen die met versie 0.1 zijn afgerekend, kun je op dezelfde manier terugbetalen.
Een terugbetaling blijft in behandeling
Mercado Pago had de terugbetaling nog niet afgerond toen het antwoordde; mogelijk werkt je winkel de status niet vanzelf bij. Zoek de terugbetaling op in je Mercado Pago-account voordat je opnieuw terugbetaalt. Als de terugbetaling is verwerkt, heeft de klant het geld terug.
Mercado Pago weigert de terugbetaling
Sommige kaartverwerkers staan terugbetalingen alleen via de terminal toe. Voer de terugbetaling uit op de Point-terminal of in je Mercado Pago-account en registreer deze daarna in WooCommerce met … handmatig terugbetalen.
Ik heb terugbetaald op de terminal of in Mercado Pago
Je winkel krijgt geen melding van terugbetalingen die daar zijn uitgevoerd, waardoor de bestelling nog steeds het volledige betaalde bedrag toont. Registreer de terugbetaling in WooCommerce met … handmatig terugbetalen, zodat het bedrag niet twee keer wordt teruggestort.
Mercado Pago Terminal instellen
Een beheerder doet dit eenmalig per winkel in WP Admin en kiest daarna op elke kassa een terminal. Je winkel bereikt elke terminal via Mercado Pago en het internet. Koppelen is dus niet nodig en elke kassa kan elke terminal gebruiken.
Vereisten
Heeft je valuta geen centen, zoals Chileense peso's, stel dan Aantal decimalen in op 0 onder WooCommerce > Settings > General. Mercado Pago weigert bedragen met decimalen voor deze accounts.
De extensie installeren
Open WP Admin > POS > Settings > Extensions, zoek Mercado Pago Terminal for WooCommerce, installeer de extensie en activeer deze. Je hebt versie 1.0 of hoger nodig; versie 0.1 is bedoeld voor WCPOS-versies ouder dan 2.0. Zie Extensies.
Je kunt ook het plugin-zipbestand (niet het zipbestand met de broncode) uploaden vanaf de GitHub-releasepagina via Plugins > Add Plugin > Upload Plugin.
Zonder WCPOS Pro 2.0 toont WP Admin Mercado Pago Terminal requires WooCommerce POS Pro 2.0 or newer. en wordt de gateway niet toegevoegd.
Je toegangstoken invoeren
Log met je verkopersaccount in bij Mercado Pago Developers en open Je integraties. Maak een applicatie aan als je er nog geen hebt en open deze. Kopieer onder Productiegegevens het Toegangstoken: dit begint met APP_USR-. Dit token is voor echte betalingen. Het token onder Testgegevens geeft alleen toegang tot de sandbox van Mercado Pago, die nog niet met deze extensie is getest.
Ga daarna naar WP Admin > WooCommerce > Settings > Payments en open Mercado Pago Terminal.

- Inschakelen — laat dit selectievakje uitgevinkt. Hiermee bied je de gateway aan in je webwinkel; de POS heeft een eigen schakelaar.
- Titel — de naam van de tegel bij de kassa.
- Beschrijving — wordt onder de titel op de betaalpagina van de winkel weergegeven.
- Modus — staat hier standaard op Test. Stel deze in op Live. De toelichting eronder is verouderd: het toegangstoken, en niet Modus, bepaalt of betalingen echt zijn.
- Toegangstoken — plak hier je productietoken. Na het opslaan blijft het veld leeg. Laat het leeg om het opgeslagen token te behouden.
- Webhookgeheim — laat dit voorlopig leeg. Je vult het in wanneer je de webhook toevoegt.
Klik op Wijzigingen opslaan.
De webhook toevoegen
Met de webhook kan Mercado Pago je winkel meteen laten weten wanneer een betaling is afgerond. Betalingen werken ook zonder webhook, omdat de kassa en je winkel Mercado Pago blijven controleren. Stel de webhook toch in, zodat een betaalde bestelling wordt afgerond als de kassa is gesloten.
- Kopieer de webhook-URL uit de beschrijving onder Webhookgeheim. Deze eindigt op
wp-json/wcpos/v2/payments/webhook?provider=mercadopago. - Open in Mercado Pago Developers Je integraties, je applicatie en daarna Webhooks. Voeg de URL toe en selecteer de gebeurtenis Bestelling (Mercado Pago).
- Kopieer de geheime handtekening die Mercado Pago toont, plak deze in Webhookgeheim en klik op Wijzigingen opslaan.
Je winkel weigert elke melding die niet met dit geheim is ondertekend. Zonder geheim doet de webhook dus niets.
Je terminals omschakelen naar PDV
Point-terminals worden geleverd in de modus STANDALONE, waarin ze geen betalingen van een kassa kunnen ontvangen. Alleen terminals in de modus PDV worden aangeboden bij het afrekenen.
- Log op elke terminal in met hetzelfde Mercado Pago-account, als je dat nog niet hebt gedaan.
- Laad de instellingenpagina van Mercado Pago Terminal opnieuw. Onder Mercado Pago-diagnostiek staat een tabel met elke terminal, het ID, de naam van de Terminal en de Modus.
- Klik bij elke terminal in de modus STANDALONE op Omschakelen naar PDV en start die terminal daarna opnieuw op. Mercado Pago vereist deze herstart.
De tabel toont maximaal 50 terminals.
Inschakelen in WCPOS
Ga naar WP Admin > POS > Settings > Checkout, zoek Mercado Pago Terminal in de tabel Betaalgateways en zet Ingeschakeld aan. Dit scherm slaat wijzigingen automatisch op; er is geen knop Opslaan.

- Mercado Pago Terminal — de rij van de extensie in de tabel Betaalgateways.
- Ingeschakeld — de schakelaar naast de gateway-ID; zet deze aan. Nadat de kassa opnieuw is geladen, toont deze de tegel Mercado Pago Terminal.
Laat Inschakelen op de WooCommerce-instellingenpagina uitgeschakeld. De POS gebruikt de gateway zodra Ingeschakeld hier aanstaat, ongeacht of dat selectievakje is aangevinkt. Zie Instellingen voor afrekenen.
De terminal voor elke kassa kiezen
Open op elke kassa Instellingen > Kaartlezers. Je terminals staan onder Slimme kaartlezers, met de namen die Mercado Pago eraan heeft gegeven. Een terminal met de status Offline is nog niet omgeschakeld: zie Je terminals omschakelen naar PDV. Druk op Deze kaartlezer gebruiken bij de terminal aan die kassa; de rij toont dan Geselecteerd. De kassamedewerker kan bij het afrekenen nog steeds op Wijzigen drukken.
Als er maar één terminal in de modus PDV staat, hoef je niets te kiezen: deze is op elke kassa al Geselecteerd. Zie Een slimme kaartlezer kiezen.
Controleren of alles werkt
-
Op de instellingenpagina van Mercado Pago Terminal staat onder Mercado Pago-diagnostiek één melding:
Inloggegevens geaccepteerd. Start de terminal opnieuw op nadat je naar PDV bent omgeschakeld.
Dit betekent dat Mercado Pago het toegangstoken heeft geaccepteerd. Staat er Mercado Pago access token is missing., dan is er geen token opgeslagen. Elke andere tekst is het antwoord van Mercado Pago op het token.
-
Onder Modus staat bij elke terminal die je wilt gebruiken PDV.
-
Laad op een kassa de POS opnieuw en druk op Afrekenen. De tegel Mercado Pago Terminal staat tussen de betaalmethoden, met je terminals boven het toetsenblok.
-
Voer een kleine verkoop uit met je eigen kaart en betaal deze daarna terug.
Bijwerken vanaf versie 0.1
- Werk eerst WCPOS, WCPOS Pro en de app bij naar 2.0 en werk daarna de extensie bij.
- Voeg de nieuwe webhook toe met het bijbehorende geheim: zie De webhook toevoegen. Het webhookadres van versie 0.1 is vervallen en meldingen zonder handtekening worden geweigerd.
- Een betaling die tijdens de upgrade bezig is, blijft behouden. Er wordt niets dubbel in rekening gebracht.
- Deze instellingen van versie 0.1 zijn vervallen: Standaardterminal, Ingeschakelde terminals, Terminalkeuze vergrendelen, Debuglogs bij afrekenen en Logniveau. Kassamedewerkers kiezen hun terminal nu onder Instellingen > Kaartlezers.
- Modus bepaalt niet langer de omgeving: controleer of het opgeslagen toegangstoken het token is dat je wilt gebruiken.
- De betaling verloopt nu via het tabblad Betalingen. Het tabblad Klassiek werkt nog steeds, maar alleen voor het volledige bedrag.
- Verkopen die met versie 0.1 zijn afgerekend, kun je op de gebruikelijke manier terugbetalen: zie Een Mercado Pago-betaling terugbetalen.
Overzicht van instellingen
Op WP Admin > WooCommerce > Settings > Payments > Mercado Pago Terminal:
| Instelling | Functie |
|---|---|
| Inschakelen | Biedt de gateway aan bij het afrekenen in je webwinkel. Laat dit uitgeschakeld; de POS heeft een eigen schakelaar onder POS > Settings > Checkout |
| Titel | De naam van de tegel bij de kassa. Standaard Mercado Pago Terminal |
| Beschrijving | Standaard Pay in person on a Mercado Pago Point terminal. |
| Modus | Test (standaard) of Live. Stel deze in op Live als je een productietoken gebruikt. Dit is alleen een label: het toegangstoken bepaalt of betalingen echt zijn, ongeacht de beschrijving van het veld |
| Toegangstoken | Mercado Pago Developers → Je integraties → je applicatie → Productiegegevens. Na het opslaan wordt het token niet meer volledig getoond, alleen de laatste tekens. Laat het veld leeg om het token te behouden. Rond openstaande betalingen af voordat je het vervangt |
| Webhookgeheim | De geheime handtekening van de webhook van je applicatie in Mercado Pago. De beschrijving toont de webhook-URL van je winkel. Wordt net als het token opgeslagen en weergegeven |
Logs en supportbundel
Onderaan de instellingenpagina staan de supportbundel, de diagnostiekmelding en een link naar de logboeken.

- Diagnostiekmelding — in deze winkel, die nog niet is ingesteld, staat Mercado Pago access token is missing.. Bij jou hoort Credentials accepted. te staan, met daaronder de terminals.
- Logboeken bekijken — opent
WooCommerce > Status > Logs, bronmercadopago-terminal. - Supportbundel downloaden — een bestand voor WCPOS-support.
De logboeken registreren elk verzoek aan Mercado Pago en het bijbehorende antwoord; het token en kaartnummers worden verwijderd.
Gaat er iets mis met een betaling, klik dan op Supportbundel downloaden en stuur het bestand samen met het bestelnummer naar WCPOS-support. WCPOS Pro voegt deze knop toe: de bundel bevat gegevens over alle POS-betaalproviders op je site, zonder geheimen en kaartnummers. Ook staat erin wanneer je winkel voor het laatst een ondertekende webhook heeft ontvangen.
Wat niet wordt ondersteund
- Fooien, of nu autoriseren en later innen.
- Een ticket afdrukken op de terminal.
- Betalingen ontvangen op terminals in de modus STANDALONE.
- Terugbetalingen registreren die op de terminal of in Mercado Pago zijn uitgevoerd.
- Valuta's omrekenen: de winkel en het Mercado Pago-account moeten dezelfde valuta gebruiken.
- Meer dan 50 terminals per account.
- Stel via WP Admin een standaardterminal voor de hele winkel in of beperk welke terminals kassamedewerkers mogen gebruiken. Elke kassa kiest zelf een terminal.
- HPOS (de besteltabellen van WooCommerce): de extensie geeft nog niet aan dit te ondersteunen.
Hoe het werkt, voor ontwikkelaars
De gateway gebruikt de Orders API van Mercado Pago voor Point (POST /v1/orders met type: point) via de betaalproviders van WCPOS Pro. Elke betaling maakt bij Mercado Pago een bestelling aan voor het bedrag op de kassa, met de terminal-ID, print_on_terminal: no_ticket, een externe betalingsreferentie en een idempotentiesleutel, zodat een nieuwe poging niet dubbel kan afrekenen. De bestelling verloopt na 5 minuten (filter mptfwc_order_expiration_time).
De kassa vraagt elke 2 seconden de status op. De webhook wp-json/wcpos/v2/payments/webhook?provider=mercadopago moet een geldige x-signature bevatten (HMAC-SHA256 met het webhookgeheim). De inhoud wordt nooit vertrouwd; de winkel haalt de bestelling opnieuw op bij Mercado Pago. WooCommerce POS controleert onbeantwoorde betalingen als extra controle elke 10 minuten.
De terminals komen uit /terminals/v1/list; alleen terminals in de modus PDV gelden als online. De filters mptfwc_order_payload en mptfwc_poll_interval_ms uit versie 0.1 zijn vervallen.
Gerelateerde documentatie
- Kaartlezers
- Het tabblad Klassiek
- Terugbetalingen
- Kassa-instellingen
- Meld een probleem op GitHub. Neem voor je account, toegangsgegevens en terminals contact op met Mercado Pago.