← Back to blog

Can a Vending Machine Take Pix? Mercado Pago and Efí, Built In

Yes. KioskForce vending machines now take Pix natively, through either of two Brazilian payment providers: Mercado Pago or Efí. The operator picks the provider and enters its own credentials in the cloud portal. The machine then shows a new Pix QR code for every sale, the customer pays it in any Brazilian banking app, and the product is released once the provider confirms the payment. There is no card reader to fit. The money settles straight to the operator’s own Mercado Pago or Efí account; KioskForce never holds it. Prices are recorded in reais (BRL). If a customer pays after the machine has already given up on the order, the payment is refunded automatically, once. Pix is QR-only on the machine today: contactless Pix por Aproximação is not supported.

KioskForce vending machines now take Pix.

Through Mercado Pago or Efí.

With no card reader in the cabinet.

The Brazil — Pix card in the KioskForce cloud portal's organisation settings, with fields for Mercado Pago (access token, webhook secret, store ID) and Efí (client ID, client secret, .p12 certificate, Pix key, sandbox) and an In use badge
Where an operator sets up Pix in the KioskForce cloud portal: Organisation Settings → QR Code Payments → Brazil — Pix. Sample data; the credentials shown are not real.

The answer in one paragraph

A KioskForce vending machine in Brazil now sells by Pix the way Brazilians already pay for everything else: scan, confirm in the banking app, done. The operator chooses Mercado Pago or Efí in the cloud portal and enters its own credentials. Every sale gets its own Pix QR code on the machine’s screen. When the provider confirms the payment, the machine releases the product. The money goes straight to the operator’s own account. Nothing extra is fitted to the machine.

We wrote in September about why Pix rewrites the payment spec for Brazil: 170 million Brazilians use it, and 60 million have no credit card (EBANX). This is the build that answers it.

How a Pix sale works

Step Where What happens
1 Cloud portal The operator selects Mercado Pago or Efí as the QR payment gateway and enters its credentials. Done once per organisation.
2 Vending machine The customer picks products. The machine shows a Pix QR code made for this order and this amount, in reais.
3 Customer’s phone The customer scans it with any Brazilian banking app and confirms. Pix settles in seconds.
4 Cloud platform The provider notifies us. We check the notification is genuine, then ask the provider for the order’s real state.
5 Vending machine Paid, for the right order and the exact amount: the product is released.
6 Operator’s account The money is already there. It never passes through KioskForce.

Mercado Pago or Efí?

Both put a Pix QR code on the machine. The difference is in the setup each provider asks for.

  Mercado Pago Efí
What the operator enters Access Token, the Order webhook’s secret signature, a store ID Client ID and Client Secret, the .p12 certificate, the Pix key payments go to
How the QR code is made A dynamic QR order through Mercado Pago’s Orders API (in-person QR Code) A Pix charge (cob) on Efí’s Pix API, with the order as its transaction ID
Per-machine setup None. Each machine gets its own point of sale under the store, created on its first order None
Payment notifications Configured once in the operator’s Mercado Pago application panel Registered automatically when the settings are saved
Test environment Use your Mercado Pago test credentials A sandbox (homologação) switch next to the credentials
Machine currency Reais (BRL) Reais (BRL) only. A machine priced in any other currency is refused, not charged

Already have a Mercado Pago seller account? Use Mercado Pago. Bank with Efí, or want payments to a specific Pix key? Use Efí. Switching later is a setting, not a rebuild.

When something goes wrong

Unattended payments fail in a few predictable ways. Here is what the platform does in each.

Situation What happens
The customer pays after the QR code has expired, or after cancelling The order is closed so it can never dispense. The payment is refunded in full, automatically, once.
The machine cancels just as the payment lands Whichever is recorded first wins. A paid order is never overwritten by a cancel, and a cancelled one is refunded, not dispensed.
The machine can’t dispense some items in a paid order Those items are refunded through the same provider. A partial refund refunds only those items.
A notification claims a payment for a different amount Ignored. The order is released only when the provider reports the exact amount paid.
A notification can’t be authenticated Rejected. No product is released and nothing is written.

Every sale also appears in the cloud dashboard with its items, machine, time and state, the same as a card or cash sale. That record comes from the machine, not from the payment provider (see payments).

Where this is the wrong answer

  • You want tap-to-pay Pix. Pix por Aproximação (contactless) is not supported on the machine. Pix here is QR only. For contactless, specify an MDB card terminal that supports it.
  • Your provider is neither Mercado Pago nor Efí. Those are the two built in. Another Pix provider is integration work, scoped and quoted per project.
  • Your machine has no screen. The QR code is drawn on the machine’s touchscreen. A machine without one needs a card terminal instead.
  • Your site has no reliable data connection. Pix confirms over the internet, so the machine sells by Pix only while it is online.
  • You need Pix on a hire or pay-to-use locker. Our hire lockers take card payments through a Nayax reader today. Pix at a locker is project-scoped integration work; see smart lockers for Brazil.

Getting it on your machines

  1. Open a Mercado Pago or Efí account and create the API credentials it asks for. For Efí, enable the Pix API with the cob.write, cob.read, pix.write, pix.read and webhook.write scopes, and download the .p12 certificate for the same environment.
  2. Price the machine in reais. Set the machine currency to BRL with two decimal places.
  3. Enter the credentials in the cloud portal under Organisation Settings → QR Code Payments, select the provider, and save.
  4. Run a test sale in the provider’s sandbox before going live.

Buying machines for Brazil? Start with the Brazil buyer’s guide, or contact us with your products, sites and provider.

Sources: KioskForce cloud platform, Pix integration for Mercado Pago and Efí, as built in November 2026; Mercado Pago developer documentation, QR Code (Orders API); Efí Pix API documentation (dev.efipay.com.br); EBANX, “Five years on, Brazil’s Pix approaches 8 billion monthly transactions” (Nov 2025). Provider fees and payout terms are the providers’ own. As at November 2026.



Want something like this built?

We design and manufacture custom vending machines, kiosks and the cloud software behind them. Tell us what you have in mind.

Project brief · 60 seconds

What are we building together?

Three quick steps. Your brief goes straight to the engineers who design, build and support KioskForce systems.

1What are you building?
2Roughly how many units? (optional)
3Where should we send your proposal?

Prefer email? sales@kioskforce.com