Cobrar con Mercado Pago
¿Para qué sirve?
Para que el cliente pague con tarjeta en la caja y el sistema se entere solo. Sin esto, alguien tiene que mirar la maquinita, ver que dice «aprobado» y marcarlo a mano en la venta — que es donde aparecen las ventas cobradas dos veces y las cobradas ninguna.
Tiene tres caminos, y los tres sirven a la vez:
- Máquina Point — la venta manda el monto a la maquinita del local. El cajero no digita nada.
- QR o link de pago — el cliente escanea o recibe un enlace y paga desde su teléfono. Sirve cuando no hay máquina, cuando está ocupada, o para cobrar un pedido antes de entregarlo.
- Botón de pago en tu sitio web — una página pública cobra sola, sin que nadie esté en la caja. Cómo se arma está más abajo, en Cobrar desde tu sitio web.
¿Cuándo lo necesitas?
- Cobras con tarjeta en un local y quieres que la venta quede cuadrada sola.
- Tienes más de un local y cada uno tiene su propia cuenta de Mercado Pago.
- Quieres cobrar sin máquina, con un QR sobre el mesón.
- Quieres que tu sitio web cobre solo, con un botón de pago en una página.
Cómo activarlo
Hay dos caminos y da lo mismo cuál uses:
- Si usas Sucursales: en Negocio → Conexiones con otros módulos, enciende el interruptor Mercado Pago. Eso instala el módulo y agrega su sección, solo. Apagarlo ahí mismo apaga todo lo que cobra — la máquina, el QR y el botón del sitio (más detalle en Sucursales).
- Si no usas Sucursales: Agregar Sección → Tipo: Plugin → Mercado Pago. El módulo no necesita la suite para cobrar: funciona igual en un negocio de un solo local.
Después, en la pantalla del módulo:
- Agrega la cuenta del negocio con sus credenciales de Mercado Pago (y, si quieres, una cuenta propia por sucursal).
- Si el local tiene máquina Point, vincúlala eligiéndola de la lista de dispositivos de esa cuenta.
Un local con cuenta propia recauda en su cuenta; el que no tenga cobra con la cuenta del negocio, que es lo que quiere una cadena que recauda todo junto. El aviso de Mercado Pago —que llega sin que nadie tenga sesión iniciada— encuentra la sucursal por la referencia del cobro, así que la plata llega a la cuenta con que se cobró, siempre.
Configuración inicial
El propio módulo trae la respuesta: pestaña «Qué tienes que llenar». Ahí está todo lo de abajo con enlaces al panel de Mercado Pago, la dirección del webhook lista para copiar, y las tarjetas de prueba.
Los dos datos obligatorios
Salen de Tus integraciones → tu aplicación en mercadopago.cl/developers/panel/app:
| Dato | Para qué |
|---|---|
| Access Token | La llave privada. Es lo único con lo que el sistema puede cobrar, y nunca sale del servidor: la pantalla dice si está puesta, no cuál es |
| Public Key | La llave pública, la que puede ir en una página. Van en par y se renuevan juntas |
Según cómo cobres
| Dato | Cuándo hace falta |
|---|---|
| La máquina (terminal) | Sólo con una Point física. No se escribe: pones el token, aprietas Buscar máquinas y la eliges |
| Caja (POS) | Sólo para cobrar con QR en el mesón. Es la caja que creaste en Mercado Pago |
Lo que hay que pegar en Mercado Pago
La dirección del webhook —la pantalla la muestra y la copia— en la sección Webhooks / Notificaciones de tu aplicación, marcando los eventos Órdenes y Pagos.
Mercado Pago tiene que poder alcanzar esa dirección desde internet. En un servidor dentro de tu casa no llega: el pago se cobra igual, pero el sistema se entera sólo cuando alguien abre la pantalla.
Al registrar el webhook, Mercado Pago muestra una firma secreta. El sistema
verifica cada aviso de todos modos consultando el pago directo al proveedor,
pero si le entregas esa firma a quien instala (va en el config.php del
módulo, como webhook_secret), los avisos mal firmados se rechazan de entrada.
Una cuenta, o una por sucursal
Si no usas Sucursales, hay una cuenta y es la del negocio. Si las usas, puedes darle su propia cuenta a cada local — y la que no tenga cobra con la del negocio, que es lo que quiere una cadena que recauda todo junto.
Modo de prueba viene encendido de fábrica: mientras esté así, no se cobra dinero real. La pantalla dice con todas sus letras si esa cuenta nunca ha cobrado de verdad, para que nadie confunda «probado» con «funcionando».
Probar sin cobrarle a nadie
Mercado Pago da cuentas de prueba (hasta 15, en la misma pantalla de tu aplicación). Necesitas dos, del mismo país: una de vendedor —de donde sacas el token que pegas acá— y una de comprador, con la que pagas.
Las tarjetas de prueba están listadas en la pestaña «Qué tienes que llenar».
Lo que hay que saber: el resultado lo decide el nombre del titular, no la
tarjeta. Escribes APRO y se aprueba; OTHE y se rechaza; CONT y queda
pendiente. El documento es 123456789.
Antes de abrirle esto a un cliente hay que hacer un cobro real y devolverlo. Es lo único que demuestra que el token, el webhook y la cuenta de destino son los correctos.
Cómo se usa día a día
El cajero no entra a esta pantalla. En Caja:
- Cobra la venta y elige tarjeta.
- El monto sale a la máquina, o aparece el QR.
- La pantalla espera y avisa cuando el pago está aprobado. Ahí recién se cierra la venta.
Si el cliente se arrepiente, el cajero cancela el intento y cobra de otra forma.
Cobrar desde tu sitio web
En Mercado Pago → Cobrar en el sitio creas botones de pago: cada uno con su nombre y su monto. Después lo insertas en cualquier página desde el generador (Páginas Web → Insertar → Cobrar con Mercado Pago).
El cliente aprieta el botón, paga en la pantalla de Mercado Pago —con tarjeta, con saldo, en cuotas— y vuelve a tu sitio. El cobro aparece en las mismas pantallas que los del mostrador, y se concilia igual.
Si el precio viajara en el HTML, cualquiera podría cambiarlo antes de pagar y el cobro sería válido para Mercado Pago. La página lleva sólo un identificador; el monto se lee de la base cada vez.
El cliente paga en la pantalla de Mercado Pago. El número de su tarjeta nunca pasa por tu servidor, que es lo que te deja fuera de toda la normativa de seguridad de tarjetas.
Retirar un botón no lo borra: las páginas que lo tengan dejan de cobrar, y lo ya cobrado se conserva.
Las cuatro barreras contra el cobro doble
Cobrar dos veces al mismo cliente es el error caro de este módulo, así que hay cuatro cosas distintas impidiéndolo:
- Cada intento de cobro lleva su propia referencia, única.
- La venta no puede guardarse dos veces con la misma referencia.
- Un mismo aviso de Mercado Pago no se procesa dos veces, aunque llegue repetido — y llega repetido.
- Mercado Pago mismo se niega. Cada cobro viaja con una llave que el proveedor recuerda 24 horas: si la petición salió y la respuesta se perdió en el camino, el reintento devuelve el cobro original en vez de hacer uno nuevo. Es la única de las cuatro que cubre el caso que no podemos ver desde acá.
Cuando el pago llega tarde
A veces el cajero se cansa de esperar, cancela y cobra en efectivo… y el pago con tarjeta entra igual, un minuto después. Ese pago no crea una venta: queda marcado como aprobado sin reclamar, y aparece en una lista para conciliarlo a mano.
No se cierra solo a propósito: convertirlo en venta significa decidir qué se vendió y a quién, y eso lo sabe una persona. Una tarea programada avisa el mismo día para que nadie lo descubra a fin de mes.
Se conecta con
- POS — es donde se cobra; la venta se cierra cuando el pago está aprobado.
- Sucursales — de ahí sale a qué local pertenece cada cuenta.
- Automatizaciones — el aviso diario de cobros sin reclamar.
Preguntas frecuentes
¿Necesito una máquina Point? No. Con QR o link de pago se cobra igual; la máquina sólo hace el trámite más corto en el mesón.
¿Sirve sin internet? No. La caja exige conexión: sin ella no hay forma de saber si un pago fue aprobado, y cobrar «a ciegas» es exactamente lo que este módulo evita.
¿Puedo devolver un pago desde acá? No. Las devoluciones se hacen desde Mercado Pago; acá queda registrado qué se cobró y con qué referencia.
¿Y si el aviso de Mercado Pago no llega nunca? La pantalla del cajero también pregunta por su cuenta el estado del cobro, así que no depende sólo del aviso.
¿Qué sigue?
- POS — la caja donde se cobra.
- Sucursales — para que cada local tenga su cuenta.
- Payku — el otro medio de cobro en línea del framework.