Guía básica para activar el panel de desarrolladores y configurar webhooks que envían pagos exitosos en tiempo real a servicios externos.
Descripción general
Trainingym Manager permite activar un sistema de webhooks para suscribirse a eventos de pagos exitosos. Desde el panel de desarrolladores, cualquier centro con permisos adecuados puede configurar puntos de conexión (endpoints) y recibir notificaciones en tiempo real con los datos necesarios para automatizar procesos externos, como la generación de facturas o integraciones con sistemas de terceros.
Beneficios del sistema de Webhooks
📌 Un sistema flexible y abierto a múltiples integraciones
-
Compatible con cualquier software de facturación o CRM.
-
Datos en tiempo real para automatizar acciones.
⚡ Inspirado en sistemas líderes como Stripe y Zapier
-
Interfaz sencilla e intuitiva.
-
Lógica basada en eventos que desencadenan acciones automatizadas.
🔗 Beneficios clave para el ecosistema de Trainingym
-
Escalable y reutilizable en distintos países y normativas.
-
No requiere desarrollo adicional por parte del centro.
-
Mejora la digitalización y automatización de gestiones internas.
Requisitos de envío de datos de transacciones
Datos del cliente:
-
Nombre
-
Apellidos (si aplica)
-
Documento de identificación (si aplica)
-
Correo electrónico (si aplica)
Datos de la transacción:
-
Tipo de transacción (tarifa, producto, etc.)
-
Concepto del pago
-
Precio unitario
-
Cantidad
-
Cupón aplicado (si aplica)
-
Descuento aplicado (si aplica)
-
Total
-
Impuestos aplicados
-
Método de pago
-
Fecha de registro
-
Fecha de valor
-
Estado (siempre exitoso)
-
ID de transacción
-
Canal de venta (empleado, online)
-
Empleado responsable (si aplica)
-
Notas adicionales (si aplica)
Funcionamiento
1. Activación del permiso Desarrolladores
Permite acceder al menú "Desarrolladores" desde Trainingym Manager. Requiere habilitación desde Mi Centro / Permisos.
2. Crear y editar puntos de conexión
Permite configurar nuevas URLs de destino, asignarles un nombre, seleccionar los webhooks disponibles (pagos exitosos) y activarlos o desactivarlos.
3. Consultar log de eventos
Desde el panel se puede acceder a un historial de eventos con filtros avanzados y acceso al detalle completo de cada petición enviada.
Limitaciones actuales del MVP
-
Solo se incluyen eventos de pagos exitosos.
-
No se exponen aún pagos fallidos ni otros eventos del sistema.
-
Límite de 10 puntos de conexión por centro.
Notas adicionales
-
El panel de desarrolladores está disponible para todos los centros con permiso activo.
-
El JSON expuesto está estandarizado y documentado para facilitar la integración con terceros.