SimpleFinance Centro de ayuda
⌕ /
Ir a la web
Centro de ayuda › Integraciones

Conectar Mercado Pago

Guardar las credenciales de tu cuenta de Mercado Pago para cobrar tus ventas con un link de pago que va directo a tu cuenta.

Dónde estáMenú lateral → ⚙️ Sistema → Configuraciones → pestaña 💳 Mercado Pago
Quién puede usarlosolo el Administrador carga o borra las credenciales. La sección Configuraciones solo aparece en el menú del Administrador (o de un usuario al que le hayan dado a mano el permiso Integraciones (ARCA/MP/Email), que igual solo puede mirar). Los links de cobro los generan el Administrador y el Editor.
Plan mínimoPersonal para entrar a Configuraciones · Pyme Plus para generar links de pago

La solapa Mercado Pago, con los pasos para conseguir el Access Token

La solapa Mercado Pago, con los pasos para conseguir el Access Token.

Antes de empezar

💎 Plan: las credenciales las podés cargar desde el plan Personal, pero para generar links de cobro necesitás Pyme Plus o superior.

Qué habilita esta integración

Con Mercado Pago conectado, cada venta pendiente puede tener un link de pago: un enlace que le mandás al cliente y que él abre para pagar con tarjeta de crédito, tarjeta de débito, efectivo (Rapipago / Pago Fácil) o saldo de su cuenta de Mercado Pago.

⚠️ Importante: el link se crea con las credenciales de tu empresa, así que la plata entra a tu cuenta de Mercado Pago. Si la empresa no tiene el token cargado, el link no se genera y en la venta no aparece el botón 💳 Generar link. Nunca se genera un cobro contra otra cuenta.

Paso a paso

1. Conseguí tu Access Token en Mercado Pago

La propia pantalla de SimpleFinance te lista los pasos en el bloque 📖 ¿Cómo obtener tu Access Token?:

  1. Entrá a mercadopago.com/developers/panel. El enlace está en la pantalla y se abre en una pestaña nueva.
  2. Creá una nueva aplicación, o seleccioná una que ya tengas.
  3. Andá a Credenciales → Credenciales de producción.
  4. Copiá el Access Token. Empieza con APP_USR-.

En esa misma pantalla está la Public Key, que también empieza con APP_USR-.

⚠️ Importante: el Access Token es la llave de tu caja registradora: cualquiera que lo tenga puede operar sobre tu cuenta de Mercado Pago y cobrar en tu nombre. No lo mandes por WhatsApp, no lo pegues en un chat y no lo guardes en un documento compartido.

2. Abrí la pestaña de Mercado Pago

Menú lateral → ⚙️ Sistema → Configuraciones → pestaña 💳 Mercado Pago.

Arriba vas a ver la barra de estado: "Sin credenciales de Mercado Pago" con ⚠️, o "Mercado Pago configurado" con ✅ y el texto "Token validado y activo".

3. Pegá las credenciales

  1. Pegá el token en el campo Access Token *. Se muestra tapado; con el botón Ver / Ocultar de la derecha podés revisar que lo pegaste bien.
  2. Si querés, pegá la Public Key (opcional).
  3. Hacé clic en Validar y guardar.

SimpleFinance consulta a Mercado Pago antes de guardar. Si el token es válido, aparece un mensaje verde con el nombre y el email de la cuenta conectada, por ejemplo "Token validado. Cuenta MP: Juan Pérez (juan@empresa.com)".

✅ Tip: leé ese mensaje. Si el nombre o el email no son los de tu empresa, copiaste el token de otra cuenta. Borralo y volvé a empezar antes de emitir ningún cobro.

🔒 Permisos: las credenciales se guardan encriptadas. El Access Token no se puede volver a ver desde la pantalla: solo se muestra si está configurado o no.

4. Cargá la clave secreta de notificaciones (recomendado)

Una vez guardado el token, debajo aparece el bloque 🔏 Clave secreta de notificaciones, con la marca · sin cargar o · cargada ✓.

Mercado Pago firma cada aviso de pago con esa clave. Con la clave cargada, SimpleFinance solo acepta avisos firmados por Mercado Pago, y descarta cualquier aviso falso que intente marcar un cobro como pagado.

  1. En Mercado Pago, entrá a Tus integraciones → tu aplicación → Webhooks y copiá la Clave secreta.
  2. En SimpleFinance, pegala en el campo Clave secreta (si ya había una, el campo se llama Reemplazar clave secreta).
  3. Hacé clic en Guardar clave.

Con Borrar clave la quitás: el sistema te pregunta "¿Borrar la clave secreta? Los avisos de pago se van a aceptar sin verificar la firma."

⚠️ Importante: la clave tiene que ser la de la misma aplicación de Mercado Pago cuyo Access Token cargaste. Si pegás la de otra aplicación, los avisos de pago se van a rechazar y los cobros no se van a acreditar solos.

Campos del formulario

Campo¿Obligatorio?Qué poner
Access Token *SíEl token de producción copiado del panel de Mercado Pago. Empieza con APP_USR-.
Public Key (opcional)NoLa clave pública de la misma aplicación de Mercado Pago.
Clave secretaNo, pero recomendadoLa clave secreta de Webhooks de la misma aplicación. Aparece después de guardar el token.

Cobrar una venta con Mercado Pago

Los links de pago se generan desde la propia venta, en 📈 Ventas / Gastos → Ventas.

Se genera solo al cargar la venta

Cuando guardás una venta nueva que cumple estas tres condiciones, el link se crea en el momento, sin que tengas que pedirlo:

El link vence a los 30 días.

Generarlo a mano

En la lista de Ventas, la fila de una venta pendiente trae el botón 💳 Generar link. Al apretarlo se crea el link y se abre en una pestaña nueva.

Cuando la venta ya tiene un link vigente sin cobrar, el botón cambia a 💳 Link y abre el enlace de cobro para que lo copies o se lo mandes al cliente.

El link se crea por el importe total de la venta y en la moneda de la venta.

Si Mercado Pago no puede crear el cobro (por ejemplo, porque no acepta la moneda de la venta o el token dejó de ser válido), la venta queda sin link y la pantalla te muestra el motivo: al apretar 💳 Generar link aparece "No se pudo generar el link en Mercado Pago: …", y si el link se iba a crear solo al guardar la venta, aparece "La venta se guardó, pero el link de Mercado Pago no se generó: …". Revisá la pestaña 💳 Mercado Pago y la moneda de la venta.

🔒 Permisos: generar un link de cobro es una acción reservada al Administrador y al Editor. Los demás roles no ven el botón 💳 Generar link y sus ventas pendientes no crean link solo.

Qué pasa cuando el cliente paga

No hay que configurar nada: al crear el link, SimpleFinance ya le indica a Mercado Pago a qué dirección avisar.

  1. El cliente paga.
  2. Mercado Pago le avisa a SimpleFinance.
  3. SimpleFinance verifica el pago contra Mercado Pago con las credenciales de tu empresa y compara el importe y la moneda contra los del link.
  4. Si el pago está aprobado y coincide:
    • el link pasa a Cobrado,
    • el pago se imputa a la venta que generó el link: la venta queda con el pago registrado (estado de pago Pagado), y si tiene factura vinculada, esa factura pasa a Pagado,
    • se registra el pago en la cuenta corriente del cliente, con el concepto "Cobro MP — …",
    • se registra el ingreso en Tesorería, en la cuenta de ingresos por defecto.

Los pagos pendientes o rechazados no se registran: solo se toman los aprobados. El aviso puede demorar unos minutos.

⚠️ Importante: el movimiento en Tesorería se registra sobre la cuenta que tengas elegida en 💰 Finanzas → Tesorería → ⚙️ Cuentas por defecto → Ingresos. Si está en Sin cuenta por defecto, el pago se imputa a la venta y a la cuenta corriente pero ningún saldo de cuenta se mueve. Si esa cuenta está en otra moneda que la venta (por ejemplo, cuenta en pesos y venta en dólares), el cobro igual se imputa a la venta y a la cuenta corriente, pero no entra a ninguna cuenta de Tesorería: te llega a la campanita (🔔) el aviso "Cobro de Mercado Pago registrado sin Tesorería" para que cargues el ingreso a mano en la cuenta correcta. Elegí la cuenta de ingresos, en la moneda en que cobrás, antes de empezar.

Si el cliente paga un importe distinto del link —de más o de menos—, o paga en otra moneda, SimpleFinance no acredita el cobro automáticamente. El link queda pendiente y te llega a la campanita (🔔) el aviso "Cobro de Mercado Pago sin registrar", con el motivo y el número de pago de Mercado Pago. Lo mismo pasa si el cobro no se pudo registrar por cualquier otro problema. La plata ya está en tu cuenta de Mercado Pago: registrá el cobro a mano por el importe real o devolvelo desde Mercado Pago. Es a propósito: acreditar un importe que no es el pactado descuadra la cuenta corriente del cliente.

Si el aviso llega dos veces, el cobro no se duplica: la aplicación detecta que el link ya está cobrado.

Revocar o rotar las credenciales

Rotar una credencial es cambiarla por una nueva. Se hace cuando sospechás que alguien más la vio, cuando se va una persona del equipo que la conocía, o como práctica periódica.

Para sacar las credenciales de SimpleFinance

  1. Andá a ⚙️ Sistema → Configuraciones → 💳 Mercado Pago.
  2. Hacé clic en Eliminar, arriba a la derecha de la barra de estado. Se borran el Access Token, la Public Key y la clave secreta.
  3. Confirmá cuando pregunte "¿Eliminar las credenciales de Mercado Pago?".
  4. Aparece el mensaje "Credenciales MP eliminadas."

Para revocar el token del lado de Mercado Pago

Borrarlas de SimpleFinance no las anula en Mercado Pago. Si el token pudo haberse filtrado, además tenés que:

  1. Entrar al panel de desarrolladores de Mercado Pago.
  2. Ir a la aplicación correspondiente → Credenciales de producción.
  3. Regenerar o revocar el Access Token desde ahí.
  4. Volver a SimpleFinance y cargar el token nuevo con Validar y guardar.

⚠️ Importante: mientras no cargues el token nuevo no se generan links de cobro, y los links ya emitidos que todavía no se cobraron pueden dejar de funcionar. Si tenés cobros en la calle, avisales a esos clientes antes de rotar el token.

Si algo no sale como esperabas

Qué vesQué pasóQué hacer
"Access Token requerido"Apretaste Validar y guardar con el campo vacío.Pegá el token y volvé a intentar.
"Token de Mercado Pago inválido: …"Mercado Pago rechazó el token. Suele ser un copiado incompleto, un token de prueba en lugar del de producción, o uno ya revocado.Volvé al panel de Mercado Pago, entrá a Credenciales de producción y copiá el token completo con el botón de copiar, no seleccionándolo con el mouse.
"La clave secreta no parece válida: copiala completa desde Mercado Pago → Tus integraciones → Webhooks."La clave pegada es muy corta, muy larga o tiene espacios.Copiala de nuevo completa, sin espacios al principio ni al final.
El mensaje verde muestra una cuenta que no es la tuyaCopiaste el token de otra aplicación o de otra cuenta.Hacé clic en Eliminar y cargá el token correcto antes de emitir cobros.
"No se pudo generar el link en Mercado Pago: …" o "La venta se guardó, pero el link de Mercado Pago no se generó: …"Mercado Pago no aceptó la creación del cobro (token vencido o revocado, o una moneda que no acepta).Revisá que el token siga válido en la pestaña 💳 Mercado Pago y la moneda de la venta, y volvé a intentar.
El botón 💳 Generar link no aparece en la ventaLa venta no está pendiente, la empresa no tiene Mercado Pago configurado, o tu rol no genera links (solo Administrador y Editor).Verificá el Estado de la venta y la pestaña 💳 Mercado Pago, o pedile el link a un Administrador o Editor.
"Tu plan no incluye: linksPago"Tu plan es anterior a Pyme Plus.Los links de cobro están desde Pyme Plus.
El cliente pagó y el link sigue pendienteEl aviso de Mercado Pago demora unos minutos, el importe o la moneda pagados no coinciden con los del link, o la Clave secreta cargada no es la de esta aplicación.Esperá unos minutos y refrescá. Mirá la campanita (🔔): si llegó "Cobro de Mercado Pago sin registrar", ahí está el motivo. Si no llegó nada, revisá la clave secreta. Registrá el pago a mano desde la venta.
En la campanita aparece "Cobro de Mercado Pago registrado sin Tesorería"La cuenta por defecto de ingresos está en otra moneda que el link.Cargá el ingreso a mano en Tesorería, en una cuenta de la moneda del cobro, y revisá la cuenta por defecto.
El cliente dice que no puede pagar el linkEl link puede haber vencido, o estás intentando pagarlo con la misma cuenta que cobra.Los links vencen a los 30 días: generá uno nuevo desde la venta. Si sos vos el que prueba, usá otra cuenta de Mercado Pago.
El cobro entró pero el saldo de la cuenta no cambióNo hay cuenta elegida en Tesorería → ⚙️ Cuentas por defecto → Ingresos.Elegí esa cuenta y cargá el movimiento faltante a mano en Tesorería.

Preguntas frecuentes

¿Uso las credenciales de prueba o las de producción? Las de producción. Con las de prueba no vas a poder cobrar de verdad.

¿A qué cuenta entra la plata? A la cuenta de Mercado Pago cuyo Access Token cargaste. El cobro se crea con las credenciales de tu empresa, no con las del sistema.

¿Para qué sirve la Public Key si es opcional? Es la clave pública de tu aplicación de Mercado Pago. No hace falta para generar links de cobro.

¿Mercado Pago me cobra comisión? Sí, la define Mercado Pago según el medio de pago y el plazo de acreditación. SimpleFinance registra el cobro por el monto del link, no por el neto acreditado. La diferencia por comisiones registrala aparte como gasto.

¿Puedo cobrar en dólares? El link se crea en la moneda de la venta. Si Mercado Pago no acepta esa moneda en tu cuenta, el link no se genera: en ese caso acordá el cobro por otro medio y registralo a mano desde la venta.

¿Tengo que cargar la clave secreta? No es obligatoria, pero es lo recomendable: sin ella, la aplicación acepta avisos de pago sin verificar que vengan de Mercado Pago.

¿Puedo mandarle el link al cliente por WhatsApp? Sí. Abrí el link con el botón 💳 Link de la venta, copiá la dirección y pegala en el mensaje.

¿Qué pasa si el cliente paga de más o de menos? El cobro no se acredita automáticamente. El link queda pendiente, te llega el aviso a la campanita y lo registrás a mano por el importe real.

Emití el link y después anulé la venta. El link sigue activo hasta su vencimiento y el cliente todavía lo puede pagar. Avisale que no lo use.

Ver también

Actualizado: 09/10/2026