Notifications for Mercado Pago: Webhooks, automatización y arquitectura serverless en acción

Introducción

Notifications for Mercado Pago es una plataforma web que permite a los usuarios conectar su cuenta de Mercado Pago con herramientas de automatización como Zapier o Make, facilitando así la integración con múltiples servicios sin necesidad de realizar tareas manuales después de cada venta o suscripción. Esta aplicación nace de una necesidad muy concreta en el contexto latinoamericano, y aprovecha al máximo tecnologías modernas como AWS Amplify, React, Node.js y DynamoDB, para ofrecer una solución escalable, eficiente y fácil de usar.

El problema a resolver

Mercado Pago es sin duda la plataforma de cobros más popular en Latinoamérica. Sin embargo, muchas plataformas globales muy utilizadas —especialmente LMS como Thinkific, Kajabi o Teachable— no ofrecen integración directa con Mercado Pago. Esto pone en desventaja a los creadores de contenido de la región, quienes se ven obligados a realizar procesos manuales para inscribir usuarios tras cada venta.

A su vez, Mercado Pago no ofrece conectores oficiales con herramientas de automatización como Zapier o Make, lo que limita aún más las posibilidades de integración.

Frente a este escenario, me propuse crear una solución que sirviera como puente: una app donde el usuario pueda conectar su cuenta de Mercado Pago con herramientas de automatización, y de esa forma automatizar procesos posteriores a una venta o suscripción, como inscripciones en LMS, envíos de emails, seguimiento en CRM o reportes en herramientas como Google Sheets.

En el siguiente video se explica el problema y cómo esta aplicación puede ofrecer una solución efectiva:

Tecnologías utilizadas

El desarrollo de esta plataforma se basó principalmente en una arquitectura serverless utilizando:

AWS Amplify (hosting, autenticación, API GraphQL, CI/CD)
React (interfaz de usuario)
Node.js + AWS Lambda (funciones backend)
Amazon DynamoDB (base de datos NoSQL)
Cognito (registro y autenticación de usuarios)
CloudWatch (logs y monitoreo)
GitHub (repositorio y automatización de despliegues)

Opté por una arquitectura serverless para reducir costos y evitar la gestión de infraestructura. Dado que el sistema se activa únicamente ante eventos (como notificaciones de pago mediante webhooks) y realiza operaciones breves y específicas —como consultar datos en Mercado Pago y enviarlos a herramientas externas—, el modelo pay-per-use de AWS Lambda y DynamoDB resulta ideal: solo se paga por las ejecuciones y el almacenamiento efectivamente utilizado, sin costos fijos por servidores en espera. Esto permite escalar sin preocuparse por la infraestructura ni por gastos innecesarios en momentos de baja actividad.

Amplify me permitió acelerar el desarrollo, ofreciendo un entorno de CI/CD ya integrado con GitHub, autenticación con Cognito preconfigurada y un conjunto de componentes de UI listos para usar. Todo esto me permitió concentrarme en la lógica del negocio sin tener que preocuparme por la infraestructura.

Funcionalidades de la aplicación

Notifications for Mercado Pago cuenta con varias funcionalidades pensadas tanto para usuarios básicos como avanzados:

Registro con email y contraseña, con confirmación por código.
Dashboard con reportes de notificaciones entrantes y salientes.
Conexión de una o múltiples cuentas de Mercado Pago mediante API Key.
CRUD de links de pago y planes de suscripción.
Webhook central para capturar notificaciones de pagos y suscripciones.
Listado de notificaciones entrantes (pagos, suscripciones) y salientes (hacia Zapier/Make).
Integración embebida con Zapier.
Generación de webhooks personalizados para integraciones avanzadas.
Gestión de usuario (cambio de contraseña, datos).
Gestión de planes de suscripción a la plataforma (vía PayPal o Mercado Pago).

El core del sistema es un webhook que recibe notificaciones de Mercado Pago, obtiene los detalles mediante la API, interpreta correctamente los distintos estados posibles (lo cual no es trivial), y luego envía la información a los servicios configurados por el usuario.

Además, desarrollé integraciones oficiales para Zapier y Make, que exponen los siguientes triggers: nuevo pago acreditado, nueva suscripción autorizada y suscripción cancelada. Estas aplicaciones permiten a los usuarios automatizar fácilmente sus flujos de trabajo sin necesidad de escribir una sola línea de código, facilitando la adopción de la automatización incluso para perfiles no técnicos.

Sitios adicionales

Para poder ofrecer planes de suscripción y gestionar a los usuarios del sistema, desarrollé en paralelo los siguientes componentes complementarios:

Panel de administración

Un panel interno que me permite consultar información de los usuarios y brindar soporte de manera rápida y efectiva. Fue una excelente excusa para aprender Next.js y desplegar en Vercel, lo cual agilizó el proceso y me resultó una grata experiencia.

Sitio institucional

El sitio principal de la app, desarrollado en WordPress, donde presento la propuesta de valor, los planes disponibles, preguntas frecuentes y guías paso a paso. WordPress me permitió implementar esto rápidamente, gracias a su flexibilidad y plugins disponibles.

Sitio web de presentación de Notifications for Mercado Pago

Aprendizajes

Esta fue mi primera experiencia utilizando varias tecnologías clave:

Amplify: me sorprendió gratamente. Pude desarrollar la UI rápidamente con los componentes de Amplify UI y contar con todo el pipeline automatizado para frontend y backend.
DynamoDB + GraphQL: me encontré con el desafío de paginar correctamente las consultas. Aprendí que el limit se aplica antes del filtro en AppSync, y que es necesario implementar el uso de nextToken para poder acceder a todos los resultados. Aunque probé OpenSearch para mejorar las búsquedas, lo descarté por el costo, optando por iteraciones paginadas en el backend.
Diseño de flujos asincrónicos: entender y controlar los distintos posibles estados de una notificación de Mercado Pago fue clave para enviar la información correcta a las herramientas conectadas.

Mejoras futuras

Uso de Lambda Layers: Actualmente hay algo de código duplicado entre funciones (como consultas a APIs o a DynamoDB) debido a que opté por crear diferentes funciones lambda que necesitan realizar una misma tarea dentro de su proceso puntual. La incorporación de Layers permitirá reutilizar lógica compartida, simplificando el mantenimiento y evitando errores.
OAuth con Mercado Pago: Planeo habilitar la conexión mediante OAuth en lugar de API Key. Ya tengo la integración funcional, pero todavía no está publicada, ya que requiere una cuenta de Mercado Pago verificada en cada país, lo que hoy limita su adopción.

Conclusión

Desarrollar Notifications for Mercado Pago fue un gran desafío y un excelente proceso de aprendizaje. Pude conectar una necesidad muy concreta del mercado latinoamericano con herramientas globales de automatización, utilizando tecnologías modernas y una arquitectura escalable.

Más allá del valor que la app puede ofrecer a los usuarios, para mí fue una oportunidad para consolidar conocimientos, aprender sobre nuevas tecnologías y dar un paso más en el camino de crear soluciones útiles y sostenibles.