Cómo Integrar Cualquier Plataforma vía Webhook Genérico

Cómo Integrar Cualquier Plataforma vía Webhook Genérico

1. ¿Qué es el Webhook de Mundpay y por qué debo usarlo?

El Webhook es una herramienta de notificación instantánea. Cada vez que ocurre un evento en tu checkout (como una venta aprobada, un Pix (método de pago instantáneo brasileño) generado o un reembolso), Mundpay envía automáticamente un "paquete de datos" (payload JSON) a una URL que registraste.

¿Por qué utilizarlo? Elimina la necesidad de revisar el panel manualmente y permite:

• Liberar acceso automático a áreas de miembros y cursos.
• Enviar mensajes inmediatos por WhatsApp (bienvenida, cobro o recuperación).
• Actualizar datos en plataformas como Zapier, Make, n8n o CRMs.

1.1. Paso a Paso: Cómo Configurar el Webhook en el Panel Mundpay

1. Accede al Dashboard: En el menú lateral de Mundpay, navega hasta la sección de Integraciones.
2. Agrega la Integración: Ve a "Webhook Genérico".
3. Haz clic en "Conectar Integración"
4. Nombra tu integración
5. Selecciona los productos desde donde recibirás los eventos
6. Define la URL de Destino: Pega la dirección de la plataforma receptora (ej.: enlace del Webhook generado por Zapier, Make, n8n o de tu propio servidor).
7. Selecciona los Eventos: Elige qué etapas de la venta deseas monitorear (recomendamos seleccionar todas para seguir todo el ciclo de vida del cliente).
8. Guarda: Haz clic en Guardar para activar el envío automático.

2. ¿Cuál es la URL de destino (Endpoint) que debo registrar?

La URL de destino es la dirección del sistema de tu servidor o de la plataforma que recibirá las notificaciones de Mundpay (ej.: [https://seu-sistema.com/webhook-vendas](https://seu-sistema.com/webhook-vendas) o el enlace generado por tu flujo en Make/Zapier).

3. Tabla de Estados de las Ventas y Acciones Recomendadas

Entiende el significado de cada estado enviado en el paquete de datos para configurar tus automatizaciones de forma eficiente:

4. ¿Cómo integrar con plataformas No-Code (Zapier, Make, n8n)?

Si no eres desarrollador, puedes conectar sistemas sin programar una sola línea de código:

1. En la herramienta No-Code (Make/Zapier): Crea un nuevo escenario/zap y define el disparador inicial como Webhooks (opción Custom Webhook o Catch Hook).
2. Copia la URL: La plataforma generará un enlace exclusivo de webhook (ej.: [https://hook.us1.make.com/](https://hook.us1.make.com/)...).
3. Pégala en Mundpay: Ingresa esa URL en el panel de Mundpay siguiendo el paso a paso de la Sección 2.
4. Envía una Prueba: Realiza una venta de prueba en el checkout (o genera un Pix/boleto) para que Mundpay envíe los datos en tiempo real y la herramienta externa reconozca la estructura de las variables.

5. Estructura Técnica de los Datos (Payload JSON)

Para desarrolladores que consumirán la API directamente en el backend, las solicitudes se envían mediante el método POST con el encabezado Content-Type: application/json.

Ejemplo del Payload enviado:

JSON

{
 "event": "paid",
 "data": {
 "transaction_id": "tx_987654321",
 "status": "paid",
 "amount": 19700,
 "currency": "BRL",
 "payment_method": "credit_card",
 "customer": {
 "name": "João da Silva",
 "email": "joao@email.com",
 "document": "12345678900",
 "phone": "+5511999999999"
 },
 "product": {
 "id": "prod_12345",
 "name": "Curso Avançado de Tráfego"
 },
 "tracking": {
 "utm_source": "google",
 "utm_campaign": "campanha_natal",
 "src": "afiliado_01"
 },
 "created_at": "2026-08-12T14:00:00Z"
 }
}

Atención (Valores Financieros): El campo amount siempre se envía en centavos. En el ejemplo anterior, 19700 representa R$ 197,00.

6. ¿Cómo probar mi integración antes de pasar a producción?

Para validar el funcionamiento sin afectar tu sistema oficial:

1. Accede al sitio gratuito Webhook.site.
2. Copia la Unique URL generada en la página.
3. Registra esa URL temporal en Mundpay.
4. Genera un Pix o finaliza una prueba en tu checkout.
5. Observa los datos llegando en tiempo real en Webhook.site para inspeccionar los encabezados y el cuerpo de la solicitud.

7. Validación de Seguridad y Buenas Prácticas (Soporte L2)

• Firma de Seguridad (HMAC SHA-256): Para garantizar que las solicitudes fueron enviadas realmente por Mundpay y prevenir ataques de falsificación (spoofing), enviamos la firma en el encabezado X-Mundpay-Signature. Valida ese hash en tu API utilizando tu clave secreta.
• Respuesta Rápida (Status 200): Tu servidor debe responder a Mundpay con un código HTTP 200 dentro de 10 segundos. Recomendamos recibir la notificación, responder 200 OK de inmediato y procesar flujos más pesados (envío de correos electrónicos, consumo de APIs de terceros) de forma asíncrona.
• Idempotencia: Usa siempre el campo transaction_id como clave única en tu base de datos para evitar el reprocesamiento o la duplicidad de accesos en caso de reintentos automáticos de envío del webhook.

¿Dudas o consultas avanzadas de schema? Accede a nuestraDocumentación Oficial para Desarrolladores.

Actualizado el: 12/08/2026