Português
Español
English
Respuesta directa
Webhook es push, API es pull. Webhook te notifica cuando algo sucede; API te permite consultar a Mundpay cuando quieras. Para liberar acceso automático, enviar mensaje o integrar CRM, webhook es suficiente. Para generar reporte, buscar cliente o auditar ventas, usa API. La mayoría de las operaciones usa los dos juntos.
¿Cuál es la diferencia práctica entre webhook y API?
Webhook es notificación en tiempo real que Mundpay te envía. API es una biblioteca de datos que consultas cuando necesitas.
| Aspecto | Webhook | API |
|---|---|---|
| Dirección | Push: Mundpay te envía | Pull: tú pides a Mundpay |
| Latencia | Segundos, apenas el evento sucede | Bajo demanda, cuando haces solicitud |
| Volumen | Un evento a la vez | Consultas de lote o filtro |
| Uso típico | Liberación de acceso, disparo de mensaje, registro en tiempo real | Reporte, auditoría, backup, consulta de cliente |
| Complejidad | Simple, no necesita servidor robusto | Más pesada, requiere manejo de error y paginación |
En la práctica: Venta aprobada, webhook llega a tu CRM en dos segundos. Cliente quiere saber cuánto gastó, tu página consulta API para traer historial de ventas. Webhook hace que la cosa suceda ahora. API proporciona la verdad cuando alguien quiere escuchar. La elección entre los dos no es "uno u otro", es una arquitectura: webhook para los eventos de ahora, API para las dudas del después. Una operación de cualquier tamaño se beneficia de tener ambos funcionando juntos, cada uno haciendo lo que hace mejor.
¿Cuándo webhook es suficiente?
Cuando todo lo que necesitas hacer es reaccionar a un evento que sucedió ahora. Venta aprobada, reembolso, cliente nuevo, venta rechazada, disputa abierta. Para cada uno, webhook notifica y tu sistema actúa.
- Liberación de acceso. Comprador compra, webhook llega, liberas acceso al área de miembros o LMS en el momento. Sin webhook, abres el panel manualmente o esperas a que el cronjob corra por la noche.
- Disparo de mensaje. Venta aprobada, webhook dispara bienvenida por WhatsApp o email. Venta rechazada, webhook dispara oferta de otro método de pago. Todo automático.
- Integración con CRM. Webhook envía datos del cliente (nombre, email, valor comprado) a ActiveCampaign, RD Station u otro CRM en el mismo momento. Así el soporte ya ve al cliente nuevo cuando llegue con dudas.
- Rastreo de pixel. Venta aprobada, webhook dispara evento para Pixel de Meta o Google, confirmando la conversión al mismo tiempo que sucede.
- Auditoría en tiempo real. Webhook registra cada venta, reembolso, disputa en tu planilla o base de datos, así siempre tienes la verdad en un solo lugar.
Si tu flujo es "venta sucede y reacciona", webhook es el camino.
El objetivo del marketing es conocer y entender al cliente tan bien que el producto le sirva y se venda solo.
¿Cuándo necesito API y no es suficiente webhook?
Cuando necesitas consultar lo que ya sucedió o sacar un reporte bajo demanda. Webhook no ofrece esto. API ofrece.
- Reporte de ventas por período. "¿Cuánto vendí la semana pasada? ¿Cuántas ventas? ¿Cuál fue el CAC promedio?" Consultas API y traes. Webhook no ofrece esto porque no notifica eventos pasados.
- Consulta de cliente específico. "¿Cuántas veces este cliente compró conmigo? ¿Cuándo fue la última compra? ¿Tiene alguna disputa abierta?" API permite buscar por email o ID. Webhook solo notifica eventos nuevos.
- Auditoría de transacciones de un producto. "Lista todas las ventas aprobadas del Producto X entre enero y marzo." API filtra y retorna la lista. Webhook no guarda historial.
- Backup y reconciliación. Traes todas las transacciones del mes via API para verificar con tu contabilidad. Webhook no puede hacer esto automáticamente.
- Dashboard customizado. Quieres mostrar al afiliado cuántas comisiones tiene abierto. Consultas API cuando accede al dashboard. Webhook no funciona así.
Si el flujo es "yo necesito traer información", API es el camino.
¿Puedo usar webhook y API juntos?
Sí, y esa es la combinación más común. La mayoría de las operaciones robustas usa webhook para eventos en tiempo real y API para consulta bajo demanda.
Ejemplo real: Vendedor usa webhook para liberar acceso automático justo después de la compra. Usa API para generar un reporte de ventas cada lunes, mostrando cuánto vendió el fin de semana. Usa API nuevamente cuando un cliente llega diciendo "no recibí la compra", para consultar si la transacción realmente se aprobó.
No es o/o. Es y/y.
¿Cómo elegir en la práctica?
Comienza con webhook. Si necesitas hacer algo automático cuando una venta sucede, webhook resuelve. Después, conforme crece, añade API para reporte y auditoría.
El roadmap típico es:
- Semana 1: Implementar webhook genérico para liberar acceso automático en el LMS.
- Semana 4: Añadir webhook para el CRM (ActiveCampaign o RD Station).
- Mes 2: Consumir API para generar reporte semanal de ventas y comisiones.
- Mes 3: Usar API para dashboard customizado visible al afiliado.
Comienza simple. Añade cuando la operación lo pida.
¿Dónde entra Mundpay en la integración?
Mundpay ofrece webhook genérico para conectar tu operación con Make, Zapier, n8n, cualquier plataforma No-Code o serverless. El webhook funciona enviando los datos del checkout (venta aprobada, Pix generado, reembolso) a la URL que configures. Consulta en la Central de Ayuda de Mundpay cómo integrar cualquier plataforma via webhook genérico para ver todos los eventos disponibles y el formato de los datos enviados.
Sobre API: una API, en general, sirve para consultar datos bajo demanda, reportes de período, historial de un cliente, verificación de transacción. Si necesitas ese tipo de funcionalidad en Mundpay, consulta la Central de Ayuda para saber qué ofrece la plataforma y cómo implementarlo.
Fuentes consultadas
- Documentación de webhook genérico para checkout de pago: basado en práctica comprobada de integración entre gateway y operaciones de infoproducto.
En resumen: Webhook o API para integrar checkout
- Webhook es notificación en tiempo real, API es consulta bajo demanda.
- Webhook es suficiente para liberar acceso, enviar mensaje, actualizar CRM, rastrear pixel.
- API es necesaria para reporte, auditoría, dashboard, consulta de cliente.
- Mundpay ofrece webhook genérico que funciona con Make, Zapier, n8n y cualquier plataforma No-Code.
- Comienza con webhook. Si necesitas API, verifica en la Central de Ayuda qué está disponible.
Preguntas frecuentes
¿Cuál es la diferencia práctica entre webhook y API?
Webhook es push: Mundpay envía. API es pull: tú pides. Webhook notifica cuando algo sucede, API consulta información cuando quieres. Para liberación automática de acceso o disparo de mensaje, webhook es más rápido. Para reporte o auditoría de ventas antiguas, API es mejor.
¿Cuándo webhook es suficiente y no necesito API?
Cuando solo necesitas saber que una venta sucedió y reaccionar en el momento. Liberar acceso, enviar email de bienvenida, disparar WhatsApp, actualizar CRM con datos del cliente. Todo esto webhook puede hacer. No necesitas consultar Mundpay nuevamente.
¿Cuándo necesito API y no es suficiente webhook?
Cuando necesitas buscar información bajo demanda. Reporte de ventas por período, consulta de cliente específico, auditoría de transacciones, listado de contracargos de un producto. Webhook no puede hacer esto. API permite leer datos siempre que necesites.
¿Puedo usar webhook y API juntos?
Sí. La mayoría de las operaciones usa webhook para eventos en tiempo real (venta aprobada, reembolso) y API para consultas bajo demanda (generar reporte, buscar cliente). Cada una hace lo mejor.
¿Cómo pruebo que mi integración está lista?
Para webhook: realiza una compra de prueba y verifica si el evento llega a la URL de destino en menos de diez segundos. Usa Webhook.site si estás probando. Para API: usa Postman o curl para hacer una solicitud GET a la API, verifica que la respuesta llegue con datos esperados e HTTP 200.
