cs-visual-time-papi icon

cs-visual-time-papi

1.0.x
(0 reviews)
API de proceso que automatiza la confirmación de pagos de pólizas de seguros entre el Portal de Pagos Corporativo y el Sistema Visual Time, garantizando sincronización en tiempo real y trazabilidad completa de transacciones.

🛡️ cs-visual-time-papi

Esta API expone operaciones del sistema de procesos Visual Time. Permite operaciones de confirmación de pago de pólizas directamente desde el Portal de Pagos.

🌐 Información Base

  • Título de la API: cs-visual-time-papi
  • Versión: 1
  • URL Base: https://cs-visual-time-papi-{env}-v1.us-e1.cloudhub.io/api/
  • Ambientes: dev, qa, prod

🚀 Cómo Comenzar

  1. Autenticación: Esta API utiliza client_id y token Bearer OAuth 2.0 para autenticación.
  2. URL Base: Usa la URL Base proporcionada como prefijo para todos los endpoints de la API.

  3. Encabezados: Incluye los siguientes encabezados en cada solicitud:

    • client_id
    • Authorization: Bearer <token>

🔄 Cómo Consumir

Puedes explorar y consumir esta API usando las siguientes plataformas:

📍 Endpoints Disponibles

MétodoEndpointDescripción
POST/portal-pagos/policy/payment/confirmationProcesa y confirma automáticamente pagos de pólizas de seguros entre el Portal de Pagos Corporativo y Visual Time, actualizando el estado de la póliza y enviando notificaciones en tiempo real cuando el pago es aprobado.

📤 Ejemplo de Solicitud (Genérico)

curl -X POST "https://cs-visual-time-papi-qa-v1.us-e1.cloudhub.io/api/portal-pagos/policy/payment/confirmation" \
-H "client_id: TU_CLIENT_ID" \
-H "Authorization: Bearer TU_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "policyId": "12345",
  "paymentDate": "2025-05-06",
  "amount": 150000
}'

⚠️ Manejo de Errores

Esta API sigue códigos de estado HTTP estándar para todas las respuestas:

  • 200 OK – La solicitud fue procesada exitosamente
  • 400 Bad Request – Parámetros inválidos o faltantes
  • 401 Unauthorized – Autenticación fallida
  • 404 Not Found – El endpoint o recurso especificado no existe
  • 500 Internal Server Error – Error inesperado del lado del servidor

📞 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 mejorada y actualizada en Noviembre 2025 por epalma@fgs.co - Edna Nayibe Palma

© 2025 Fundación Grupo Social - Colmena. Archivo generado para la API cs-visual-time-papi

📋 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 rota tokens regularmente.

Reviews