Integrar Mercado Pago con un ERP argentino en 2026 se hace por tres vías: middleware tipo Zapier o Make (20 a 60 USD al mes), conector partner para Tango Gestión, Bejerman, Holistor o Calipso (50 a 200 USD al mes), o desarrollo a medida con webhook handling, conciliación bancaria, timbrado AFIP nativo y outbox pattern para idempotency. El patrón correcto es: webhook de Mercado Pago llega a queue persistente, worker procesa con idempotency_key, registra movimiento en el ERP, timbra factura electrónica AFIP y guarda audit log append only. Para pyme argentina con más de 500 pagos al mes, el sistema propio amortiza en menos de 18 meses.
Si eres COO, CFO o jefe de sistemas de pyme argentina con Mercado Pago como pasarela principal y necesitas que tu ERP refleje cada pago sin doble digitación, esta guía te lleva paso a paso.
Paso 1: Configurar webhooks en Mercado Pago
Mercado Pago expone API REST en api.mercadopago.com y webhooks bajo el nombre Notificaciones IPN o Webhooks. En tu Dashboard de Mercado Pago vas a Tu negocio luego Configuración luego Notificaciones, y registras tu URL pública.
Eventos clave para integrar con ERP:
- payment.created cuando se crea un pago nuevo
- payment.updated cuando cambia estado (approved, rejected, refunded, charged_back)
- merchant_order.updated para órdenes con múltiples pagos
- plan.updated y subscription.updated si manejás suscripciones
URL típica: https://tu-api.com/webhooks/mercadopago. Mercado Pago manda POST con JSON {"id": "123456", "topic": "payment"}. Tu API debe responder 200 OK en menos de 22 segundos o Mercado Pago reintenta.
Paso 2: Implementar handler idempotente
El handler correcto sigue el patrón outbox:
- Validar firma del webhook con tu access_token
- Llamar a la API de Mercado Pago para traer el detalle del pago (GET /v1/payments con el id)
- Insertar en tabla outbox.payments con idempotency_key = payment.id
- Responder 200 OK al webhook
- Worker asincrónico procesa outbox, registra en ERP, timbra AFIP
Sin idempotency, Mercado Pago puede mandar el mismo webhook 2 a 3 veces y tu ERP termina con pagos duplicados.
Paso 3: Registrar movimiento en el ERP argentino
Cada ERP argentino tiene su API:
| ERP | API | Endpoint típico |
|---|---|---|
| Tango Gestión | Servicio web SOAP local | localhost:8080/tango |
| Bejerman | REST API limitada | api.bejerman.com.ar |
| Holistor | REST API | api.holistor.com |
| Calipso | REST API moderno | api.calipso.com |
| Odoo Argentina | XML-RPC o REST | tu-odoo.com/web/api |
Tu worker llama al endpoint correspondiente con el payload del movimiento (cuenta contable, importe, fecha, referencia Mercado Pago). El ERP responde con ID del movimiento. Guardas ese ID en tu base intermedia para conciliación posterior.
Paso 4: Timbrar AFIP con WSFEv1
Cuando el pago es de un cliente final, necesitas factura electrónica AFIP. El worker:
- Obtiene Token Authorization (TA) vigente desde WSAA
- Arma comprobante WSFEv1 con datos del receptor y del pago
- Llama a FECAESolicitar
- AFIP devuelve CAE
- Guarda CAE en tu base junto al ID Mercado Pago y al ID ERP
Si AFIP cae (es frecuente fin de mes), reintenta exponencial cada 15 minutos hasta que responda. El cliente final recibe recibo provisorio en checkout y factura AFIP por email cuando AFIP responda.
Paso 5: Conciliar pagos con tu cuenta bancaria
Mercado Pago liquida a tu CBU en T+10 o T+14 según tu cuenta (estándar o Money). La conciliación correcta:
- Pull diario de la API Mercado Pago de liquidaciones (GET /v1/account/settlements)
- Cruzar contra extracto bancario (CBU vía Open Banking o archivo manual)
- Confirmar que cada lote Mercado Pago coincide con depósito bancario
- Si hay desfase, alertar al equipo financiero
- Registrar liquidación en cuenta contable de Mercado Pago
Sin este paso, tu balance ERP muestra pagos pero tu banco no, y el contador pasa días al mes cuadrando.
Tabla comparativa rápida
| Criterio | Zapier | Conector partner | A medida |
|---|---|---|---|
| Costo mensual | 20 a 60 USD | 50 a 200 USD | 50 a 150 USD pass through |
| Idempotency | Limitada | Vía proveedor | Total (UUID propio) |
| Timbrado AFIP | Paso extra | Incluido normalmente | Incluido |
| Conciliación bancaria | No | Parcial | Total |
| Multi canal | No | Limitado | Total |
| Dueño del código | Zapier | Proveedor | Tú, 100 por ciento |
El caso real: outbox pattern con write back
Una distribuidora multi país con 100 franquicias necesitaba write back desde su sistema Catalizadora hacia un ERP central. Catalizadora implementó:
- Outbox queue en Postgres con idempotency_key UUID por transacción
- Trigger en app.leads on INSERT BOOKED genera fila en outbox.cierres_venta
- Worker Python con retry exponencial (1s, 2s, 4s) llama a la API del ERP
- Audit log append only registra cada intento, éxito o fallo
- CDC (Change Data Capture) vía replicación lógica para histórico
Resultado: cero pérdida de transacciones, idempotency garantizada, reintentos automáticos sin intervención humana. Exactamente el patrón que necesita una integración Mercado Pago a ERP argentino seria.
Lo que NO debes hacer
Tres errores típicos:
- Procesar el webhook sincrónico dentro del handler: si tu ERP tarda, Mercado Pago da timeout y reintenta, duplicando pagos
- Sin idempotency_key: te duplica entre 2 y 5 por ciento de pagos al mes
- Saltarte conciliación bancaria: tu ERP miente sobre cuánto dinero realmente entró a tu cuenta
Próximos pasos
Si recién arrancas tu integración Mercado Pago a ERP en Argentina, un Zap o conector partner cubre los primeros meses. Cuando ya cruzas 500 pagos al mes o necesitas multi canal con AFIP automático, vale la pena construir el flujo propio.
Catalizadora arma el diagnóstico en una llamada de 30 minutos, sin pitch deck, conversación real sobre tu operación.
- MAGIA Core construye sistemas a medida con Mercado Pago, AFIP, ERP y conciliación bancaria en 12 semanas por 15,000 USD. Código a tu nombre.
- Para pymes muy pequeñas que solo necesitan ecommerce, CRM y cobros listos, MAGIA Solo cubre desde 4,500 USD en 15 días.