Los Webhooks te permiten recibir notificaciones automáticas en tiempo real cada vez que ocurre un evento en tu negocio.
En lugar de consultar constantemente la API, Tiendup envía una notificación (HTTP POST) a la URL que configures cuando sucede algo importante, como una venta, una inscripción o la activación de una suscripción.
Esto te permite:
Automatizar procesos externos.
Sincronizar datos con tu CRM.
Activar campañas en herramientas de email marketing.
Actualizar sistemas propios en tiempo real.
Integrar Tiendup con desarrollos personalizados.
📌 Eventos disponibles
Actualmente puedes suscribirte a los siguientes eventos:
🛒 Ventas
orders.creation → Nueva venta
orders.payment_paid → Confirmación de pago
🎓 Cursos online
learning.course_enrollment → Nueva inscripción
learning.course_completed → Curso completado
🎟️ Eventos
events.event_enrollment → Nueva inscripción a evento
📥 Descargables
downloadables.content_access → Nuevo acceso a contenido
🔁 Suscripciones
subscriptions.activated → Suscripción activada
subscriptions.deactivated → Suscripción desactivada
🛠️ ¿Cómo configurar tu primer Webhook?
Ingresa a tu panel administrativo.
Ve a Configuraciones → Webhooks.
Haz clic en Crear Webhook.
Ingresa la URL donde deseas recibir las notificaciones.
Selecciona los eventos que deseas recibir.
Haz clic en Guardar.
🔐 Firma secreta (seguridad del webhook)
Cada webhook generado tiene una firma secreta única.
Puedes encontrarla dentro del detalle del webhook.
¿Para qué sirve?
La firma secreta te permite validar que las notificaciones recibidas provienen realmente de Tiendup y no de una fuente externa.
En cada request enviado por Tiendup se incluye el header:
x-tiendup-signature
Tu servidor debe:
Leer ese header.
Verificar que coincida con la firma generada.
Solo procesar el request si la firma es válida.
Si los valores no coinciden, debes rechazar la solicitud.
⚠️ Importante:
No compartas tu firma secreta públicamente.
No la incluyas en código frontend.
Trátala como una clave privada.
🧪 ¿Cómo probar el envío de Webhooks?
Puedes enviar eventos de prueba para validar que tu endpoint funciona correctamente.
Ve a Configuraciones → Webhooks.
Selecciona el webhook que deseas probar.
Haz clic en Enviar evento de prueba.
Espera unos segundos.
Verifica en tu sistema externo que el request haya sido recibido.
También podrás ver el resultado de la ejecución en el historial del webhook.
Puedes repetir las pruebas las veces que necesites.
🚀 Buenas prácticas
Tu endpoint debe responder con código HTTP 200 para confirmar recepción.
Evita tiempos de respuesta largos.
Registra los intentos fallidos.
Implementa manejo de reintentos en tu sistema.