Cobrar con MercadoPago

Los siete pasos, en orden

Configurar el cobro por QR lleva una vez, y el orden importa: cada paso se apoya en el anterior, y saltearse uno da un error que casi nunca dice lo que pasa de verdad.

Esta guía los recorre en detalle más abajo. Esto es el mapa, para que sepas dónde estás parado.

1. Creá la aplicación correcta en tu panel de MercadoPago. Es el paso que nadie adivina, y el que más tiempo cuesta si sale mal.
2. Copiá el Access Token de producción de esa aplicación y pegalo acá.
3. Configurá el webhook en MercadoPago con la URL que te muestra esta pantalla, y suscribí el evento «Órdenes».
4. Pegá acá la clave secreta que MercadoPago te da al guardar ese webhook.
5. Completá la dirección del local con la ciudad y la provincia escritas como las tiene MercadoPago.
6. Tocá «Crear la caja y generar el QR».
7. Imprimí el cartel y pegalo en el mostrador.

Paso 1 — Qué aplicación crear, y por qué importa cuál

En MercadoPago los permisos NO son de tu cuenta: son de cada aplicación que creás dentro de ella. Una aplicación creada para cobrar suscripciones no puede generar el QR de un mostrador, y tu cuenta puede estar perfectamente habilitada igual.

Si te equivocás acá, el error que vas a ver dice «MercadoPago no autorizó esta operación». Suena a que hay que pedir un permiso y esperar una respuesta. Casi siempre no es eso: es que la aplicación es de otro tipo, y se arregla en diez minutos creando la correcta.

Y ojo con una salida que parece obvia y no funciona: tener las dos aplicaciones en la misma cuenta no alcanza. Acá entra un solo Access Token, así que el que pegues es el que decide qué se puede hacer.

1. Entrá a tu panel de MercadoPago, a «Tus integraciones».
2. Creá una aplicación nueva. Cuando te pregunte qué vas a integrar, elegí la opción de pagos presenciales o QR — no la de suscripciones ni la de pagos online.
3. Si ya tenías una aplicación creada para otra cosa, dejala donde está y creá esta aparte.

Este paso no se puede verificar desde visnes antes de intentarlo: MercadoPago recién contesta que no cuando vas a crear la caja. Si llegaste hasta ahí y te rebotó, volvé acá primero.

Pasos 2 a 4 — El token y el aviso de pago

Son dos datos distintos y los dos hacen falta. El Access Token es con lo que visnes cobra en tu nombre. La clave del webhook es con lo que visnes comprueba que el aviso de «este cliente pagó» viene de MercadoPago de verdad, y no de cualquiera.

El segundo es el que se olvida, y el síntoma no dice lo que pasa: el cobro se genera, el cliente paga, y en visnes la venta queda esperando para siempre. Sin esa clave el aviso llega y se rechaza, porque no hay forma de saber si es auténtico.

1. En tu aplicación → Credenciales de producción, copiá el Access Token y pegalo en visnes. Tiene que ser el de producción, no el de prueba.
2. En esa misma aplicación entrá a Webhooks y pegá exactamente la URL que visnes te muestra en pantalla. No la escribas a mano ni la armes vos: si le falta un pedazo, los avisos no llegan y no hay ningún error que lo diga.
3. Suscribí el evento «Órdenes» (aparece como «Order» u «Orders»). Si tu panel todavía muestra «Pagos», marcá los dos: que sobre uno no rompe nada, que falte sí.
4. Guardá. MercadoPago te va a dar una clave secreta. Copiala y pegala en visnes, en el campo de la clave del webhook.

Si te falta la clave, visnes te lo reclama con un cartel que no se puede descartar. Es lo único de esa pantalla que se traduce directo en plata que entró y que el sistema no registró.

Paso 5 — La dirección del local se valida contra una lista

MercadoPago necesita la dirección para crear la caja, y no acepta cualquier cosa: compara la ciudad y la provincia contra su propia lista, y además comprueba que esa ciudad pertenezca a esa provincia.

Por eso hay que escribirlas completas, con tilde y con mayúscula inicial en cada palabra, tal como figuran oficialmente. «Córdoba», no «cordoba». «Cruz del Eje», no «Cruz del eje».

Un aviso sobre el mensaje de error, porque nos costó una tarde: cuando esto falla, MercadoPago dice que el problema está en la provincia. Puede estar mintiendo — el error salta igual cuando la que no coincide es la ciudad. Revisá las dos.

Y si tu local está en la Ciudad de Buenos Aires, MercadoPago no la llama «CABA» ni «Buenos Aires»: en su lista figura como «Capital Federal», y va así tanto en la provincia como en la ciudad.

La ubicación en el mapa se completa pegando el link de Google Maps de tu local. Buscalo, copiá el link de la barra de direcciones y pegalo: visnes saca las coordenadas de ahí.

Paso 6 — El QR fijo del mostrador

Es el modelo de las estaciones de servicio: un código impreso, pegado en el mostrador, siempre el mismo. Cuando cerrás una venta, el monto se le carga a ese código y el cliente escanea y paga desde su app de MercadoPago.

Se activa con un botón. visnes crea la tienda y la caja en TU cuenta de MercadoPago y te devuelve el código y un PDF listo para imprimir. Si tenés más de un local, hay un código por local.

Sin esto el cobro funciona igual, pero es otra cosa: lo que se genera es un link a una página web de pago. El cliente que lo escanea abre el navegador en vez de pagar dentro de su app. La pantalla te lo avisa mientras estés en ese modo.

Si en un mismo local hay dos personas cobrando a la vez con el mismo código, un cliente puede terminar pagando el importe de la otra venta. Para ese caso conviene seguir con el link de pago, que es distinto en cada venta.

Si algo falla al crear la caja

Los mensajes de error de esta pantalla están escritos para que sepas qué tocar. Estos son los que aparecen, y qué significa cada uno de verdad.

«MercadoPago no autorizó esta operación»: casi siempre es el paso 1, la aplicación es de otro tipo. Revisá eso antes de escribirle a nadie.

«Revisá la dirección»: es el paso 5. Empezá por la ciudad, aunque el mensaje nombre la provincia.

«Ya existe una caja con ese identificador»: no es un problema. Volvé a intentar y visnes reusa la que ya está en tu cuenta, en vez de crear otra.

«MercadoPago rechazó el identificador de la caja», o un error con un número de tres cifras: eso es nuestro, no tuyo. Avisanos con ese número. Reintentar no lo va a resolver.

Nada de lo que se crea acá se puede borrar desde visnes: la tienda y la caja viven en tu cuenta de MercadoPago. Por eso los reintentos están hechos para reusar lo que ya está, y no para llenarte la cuenta de locales repetidos.

Paso 7 — Imprimirlo y dejarlo a la vista

El botón «Imprimir el cartel» arma una hoja lista para pegar: el nombre de tu comercio arriba, el código grande en el medio y una línea que le explica al cliente qué hacer. Se abre el diálogo de impresión de siempre.

Elegís dónde lo vas a pegar y el tamaño sale solo: «en el mostrador» es media hoja, la medida de un parante de acrílico; «en la pared» es una hoja entera, para que se lea desde la fila.

Al lado queda el PDF que arma MercadoPago, por si preferís el diseño de ellos. Ese no lleva el nombre de tu local.

El código va impreso a un tamaño pensado para que un celular lo lea desde el otro lado del mostrador. Si lo achicás fotocopiándolo o lo imprimís en una etiqueta chica, puede dejar de leerse — y eso se descubre con un cliente adelante.

Cómo cobra el cajero, una vez configurado

Con el QR activo, una venta por MercadoPago funciona como un posnet: la venta NO existe hasta que el pago aprueba. No se toma número de comprobante, no se pide CAE, no se descuenta stock y no se imprime nada.

Eso cambia una costumbre, y conviene decirlo en el mostrador: no se entrega la mercadería hasta que la pantalla confirma el cobro. Antes de eso, para el sistema esa venta todavía no pasó.

Si el cliente se arrepiente y se va, no queda nada: ni un número gastado, ni stock movido, ni una venta fantasma en el arqueo. El cobro se descarta solo a los dieciséis minutos.

Y no hace falta quedarse mirando la pantalla. El aviso de MercadoPago llega igual y la venta se emite sola, aunque hayas cerrado el navegador. Al volver, el comprobante está y lo podés imprimir desde ahí mismo.

Si el cobro entra y por alguna razón el comprobante no se puede emitir, visnes no se lo guarda: queda marcado y nos llega un aviso. Un cliente que pagó y se fue sin ticket es lo que este circuito existe para que no pase en silencio.

Cuánto te queda, y cuándo lo tenés

De cada cobro, visnes guarda lo que pagó el cliente, lo que te queda a vos y la comisión que se llevó MercadoPago. No sale de un porcentaje cargado a mano: la comisión cambia según el medio de pago y el plazo de acreditación, y la informa MercadoPago cobro por cobro.

También se guarda la fecha en la que ese dinero se libera. No es el día del cobro: MercadoPago retiene el dinero un tiempo que depende del plazo que tengas configurado en tu cuenta, y puede ser de días o de semanas.

Eso es lo que explica la diferencia entre lo que vendiste y lo que ves disponible en tu cuenta de MercadoPago. No falta plata: todavía no se liberó.

Probar antes de cobrar de verdad

MercadoPago tiene dos juegos de credenciales: las de prueba y las de producción, y son cuentas distintas. Un QR creado con las de prueba no cobra en la de producción, y al revés tampoco.

Si activaste el QR fijo estando en modo prueba y después pasás a producción, hay que volver a activarlo. visnes lo sabe y no mezcla los dos: no vas a quedarte con un código que parece bueno y no cobra.

La prueba que vale es cobrarte a vos mismo un monto chico con la cuenta de producción, escaneando el cartel impreso con tu propio teléfono. Es la única que ejercita el circuito entero, de punta a punta.