Mercado Pago integration · Point and QR

Charge with Mercado Pago without typing an amount.

The amount comes from the sale and goes straight to the Point terminal or to a QR on screen. The approved payment comes back to the till on its own, with card, instalments and operation number. If something drops, Kubrik rescues it. Nobody keys in amounts and no payment is left hanging.

Point + QR
Terminal in POS mode, or a dynamic QR on the till screen.
Exact amount
The till sends the sale balance. The customer types nothing.
Signed
Every Mercado Pago notice is verified by its signature before it touches a sale.
Rescue every 2 min
An unconfirmed payment is checked automatically until it settles.
Setup from Kubrik

Kubrik builds the Mercado Pago till for you.

There's no need to open the Mercado Pago panel to create tills or switch terminal modes. Everything is done from the Mercado Pago tab of the POS fiscal configuration, and each step is checked against Mercado Pago before it's saved.

  • If you load a test account as live, or the other way round, Kubrik detects it and won't save it.
  • The till must belong to the chosen store and use a fixed amount, so the buyer never types the total.
  • Only one terminal in POS mode per till. If another one is there, Kubrik warns you.
  • The live account can't be switched while tills are open, and each payment remembers which account it used.
You connect your Mercado Pago account
GET /users/me → 123456789 · PRODUCTION
Kubrik creates the till in Mercado Pago
POST /pos · external_id CFLORIDA · fixed_amount
It links it to your point of sale
PV 0003 · Sucursal Florida → CFLORIDA
It brings in your Point terminals
GET /terminals/v1/list → NEWLAND_N950__SBX0000001
It puts the terminal in POS mode
PATCH /terminals/v1/setup → operating_mode PDV

Kubrik suggests the till identifier from the branch and point of sale. You can also enable a till you already created in Mercado Pago. The example data is fictitious.

Charging with Point

From F5 to "payment approved", without anyone touching a number.

This is a payment with the Point terminal in POS mode. Click a step or let it play.

[16:05:11] POS F5 · saldo $ 81.735,00 → POST /v1/orders type=point
[16:05:12] MP ORD01JV3AW3… at_terminal · ticket #4231-018 · vence PT3M
[16:05:31] MP cliente paga · Visa crédito · 1 cuota
[16:05:33] HOOK order.processed · firma válida · GET /v1/orders/ORD… → processed
[16:05:33] POS cobro CAPTURED · Visa ···3704 · PAY01JV3AW4 · saldo $ 0,00

The identifiers are examples. The states and calls are the real ones from Mercado Pago's Orders API.

And when it doesn't go as expected

Payment declined · Insufficient funds

The cashier sees the reason in words, not a code: declined by the bank, insufficient funds, over the card limit, card disabled, the bank asks for phone authorization, instalments not available. They can try another method on the same sale.

Charging with QR

One QR per sale, on the till screen.

With F6 the till shows a QR generated for that sale, with the amount already set. The customer scans it with whatever wallet they use and the till finds out on its own.

Interoperable

Pay with Mercado Pago, Cuenta DNI, Modo, Ualá, Personal Pay and other wallets.

With the sale details

Items travel with the order. For a partial payment or a weighed sale, a single line with the ticket number goes instead.

Expires on its own

After 5 minutes, configurable. The till checks every 5 seconds and closes the payment as expired if nobody paid.

No printed QR

The QR is dynamic with a fixed amount: there's no counter sign anyone could swap.

ARS 81.735,00
Waiting for payment · expires in 05:00
Mercado PagoCuenta DNIModoUaláPersonal Pay
Sample QR: scanning it charges nothing.
Payment confirmation

Three ways to find out. No payment gets lost.

If the internet drops or a notice never arrives, another path settles it. All three end in the same place, and applying the same payment twice has no effect.

Mercado Pago's noticeSignature verified, 5-minute anti-replay window and no duplicates.
The till's own checkEvery 2 seconds for Point and every 5 for QR, while the cashier waits.
The automatic rescueEvery 2 minutes it finds unresolved payments and checks them, even if the till is already closed.
One single result on the sale Approved, declined, cancelled or expired. If the amount paid doesn't match the one requested, the payment is set aside and the sale won't close. If a payment arrives after cancelling, it's recorded so it can be refunded.

Stuck payments screen

The manager sees payments older than 5 minutes and can force a check, mark one as paid with its payment number, or void it with a note.

Everything is audited

Cancellations, terminal confirmations, late payments, refunds and manual fixes, with who did them: a person or the system.

The till knows whether it can charge

If the Mercado Pago till is missing or no terminal is in POS mode, the F5 and F6 buttons turn off and explain why.

Refunds and security

Money goes back the way it came in.

Refunds

  • A return with a credit note refunds through Mercado Pago, in full or in part, from Kubrik.
  • Voiding a sale that was already paid refunds each chosen payment. If a refund fails, it waits on a screen to be resolved.
  • Kubrik checks Mercado Pago's deadlines: 180 days for cards and 90 for wallet. Past them, it suggests cash or a voucher.
  • A partial refund never exceeds what's left to refund.

Security

  • The access token and notice secret are stored encrypted with AES-256-GCM and never shown.
  • Every notice is validated with HMAC-SHA256 before it touches a sale. One with a bad signature is rejected and not stored.
  • Configuring Mercado Pago needs its own permission. Cashiers charge; they don't configure.
  • There's an internal test mode for training without moving money, and the till warns when the account is a test one.
Technical sheet

The numbers behind each payment.

Timings
WhatValue
Point order expiry3 min
QR expiry5 min, configurable
Till check2 s Point · 5 s QR
Wait per call to Mercado Pago10 s
Automatic rescueevery 2 min
Notice anti-replay window5 min
Refund deadline180 days card · 90 wallet
Payment states at the till
Awaiting terminalthe order is on the Point
Check terminalthe cashier confirms what happened
Capturedcounts toward the sale
Declined · Cancelled · Expireddoesn't count, can be charged again
Amount mismatchset aside, the sale won't close
Paid after cancelrecorded for refund
Refundedreturned to the original method

Charge and invoice on the same screen.

Mercado Pago charges, ARCA authorizes, and Kubrik POS ties both together in a single sale.