cs-webhook-xapi

(0 reviews)

Procesa confirmaciones de pago PayU integrando Visual Time, Salesforce y servicios de autenticación Colmena. Gestiona transacciones automáticas y referencias comerciales en tiempo real.

🛡️ cs-webhook-xapi

Procesa confirmaciones de pago PayU integrando Visual Time, Salesforce y servicios de autenticación Colmena. Gestiona transacciones automáticas y referencias comerciales en tiempo real.

Este webhook centraliza la recepción de notificaciones automáticas de sistemas externos y orquesta las integraciones necesarias para:

Confirmaciones de pago desde la plataforma PayU
Actualización de estados de correos electrónicos y notificaciones
Sincronización con CRM Salesforce para actualización de oportunidades
Validación de tokens y autenticación con servicios Colmena
Integración con Visual Time PAPI para gestión de tiempo
Procesamiento de firmas digitales y políticas de pago
Manejo de referencias comerciales y estados de transacciones

Todos los servicios se exponen a través de endpoints REST seguros con autenticación por client_id y proporcionan procesamiento asíncrono optimizado para alta disponibilidad.

🌐 Información Base

Título de la API: cs-webhook-xapi
Versión: 1.0.0
Plataforma: MuleSoft Anypoint Platform
URL Base Producción: https://cs-webhook-xapi-prod.us-e1.cloudhub.io/api/
URL Base QA: https://cs-webhook-xapi-qa.us-e1.cloudhub.io/api/
URL Base Desarrollo: https://cs-webhook-xapi-dev.us-e1.cloudhub.io/api/
Protocolo: HTTPS/REST
Formato de Datos: JSON
Autenticación: Client ID Enforcement

🚀 Cómo Comenzar

Autenticación: Asegúrate de tener el client_id requerido para acceso seguro.
URL Base: Usa la URL Base proporcionada como prefijo para todos los endpoints de la API.
Encabezados: Agrega los siguientes encabezados en tus solicitudes de API:

-H "Content-Type: application/json"
-H "client_id: TU_CLIENT_ID"
-H "X-Correlation-ID: TU_CORRELATION_ID"  # Opcional pero recomendado para trazabilidad

🚀 Cómo Consumir

Puedes acceder y consumir esta API a través de las siguientes plataformas:

🔗 MuleSoft Exchange (Webhook API)
🔗 Portal Público FGS

📍 Endpoints Disponibles

Método	Endpoint	Descripción
POST	`/api/payu/web-checkout/confirmation`	Recibir confirmaciones de pago desde PayU web checkout
PATCH	`/api/updateEmailStatus/{id}`	Actualizar estado de correos electrónicos por ID

⚠️ Manejo de Errores

Se utilizan códigos de estado HTTP estándar para el manejo de errores:

📊 Códigos de Respuesta

Código	Estado	Descripción	Causa Común	Acción Recomendada
`200`	✅ OK	Confirmación procesada exitosamente	Webhook recibido y procesado	Continuar con el flujo normal
`400`	❌ Bad Request	Datos de confirmación inválidos	Firma incorrecta o campos faltantes	Revisar estructura del payload y firma
`401`	🔒 Unauthorized	Autenticación fallida	Client_id inválido o faltante	Verificar credenciales de autenticación
`403`	🚫 Forbidden	Sin permisos para webhook	Client_id sin permisos para el endpoint	Verificar permisos asignados
`422`	⚠️ Unprocessable Entity	Error en procesamiento de datos	Datos válidos pero no procesables	Verificar estado de servicios externos
`500`	💥 Internal Server Error	Error inesperado en el servidor	Fallo interno del sistema	Contactar soporte técnico
`503`	🛠️ Service Unavailable	Servicio temporalmente no disponible	Mantenimiento o sobrecarga	Reintentar más tarde

🔧 Integraciones y Dependencias

Servicios Integrados:

PayU Payment Gateway
- Recepción de confirmaciones de pago
- Validación de firmas digitales
- Procesamiento de estados de transacción
Salesforce CRM
- Actualización de oportunidades comerciales
- Sincronización de referencias de pago
- Gestión de estados de cliente
Visual Time PAPI
- Registro de eventos de pago
- Sincronización de tiempos de proceso
- Trazabilidad de transacciones
Servicios de Autenticación Colmena
- Validación de tokens de seguridad
- Autenticación de servicios
- Gestión de sesiones empresariales

📞 Soporte

Para asistencia, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.

Correo electrónico: epalma@fgs.co

📅 Información Adicional

Documentación generada y actualizada en Noviembre 2025 por epalma@fgs.co - Edna Nayibe Palma

📋 Nota Importante: Esta documentación se actualiza continuamente. Para la versión más reciente y cambios en tiempo real, consulta siempre el Portal de Exchange oficial.

🔒 Aviso de Seguridad: Nunca compartas credenciales de API en repositorios públicos o documentación. Usa siempre variables de entorno para información sensible y valida todas las firmas de webhook entrantes.

⚡ Rendimiento: Para óptimo rendimiento, procesa webhooks de forma asíncrona y implementa patrones de circuit breaker para servicios externos.

home