Pagos

(0 reviews)

API de experiencia que expone servicios para la gestión de pagos de seguros generales, incluyendo pagos con tarjeta de crédito, PSE y procesamiento de transacciones mediante integración con el gateway PayU

🛡️ cs-payments-xapi

La API cs-payments-xapi provee una capa de experiencia para la gestión de pagos de seguros generales, permitiendo la integración con el gateway de pagos PayU a través de múltiples métodos de pago.

Expone operaciones REST para:

Procesamiento de pagos con tarjeta de crédito
Procesamiento de pagos por PSE
Procesamiento de transacciones mediante WebCheckout (formulario HTML PayU)

La API actúa como una Experience API (XAPI), gestionada desde MuleSoft Anypoint Platform.

🌐 Información Básica

Nombre de la API: cs-payments-xapi
Versión: 1
Plataforma: MuleSoft Anypoint Platform
Tipo: Experience API
URL Base QA:https://cs-payments-xapi-qa-v1.us-e1.cloudhub.io/api/
Protocolo: HTTPS / REST
Formato de Datos: JSON

🔐 Autenticación

Para consumir esta API, el consumidor debe enviar obligatoriamente en cada solicitud los siguientes mecanismos de seguridad:

Client ID Enforcement
- Headers requeridos:
  - client_id
  - client_secret
- Las credenciales son asignadas a la aplicación consumidora en MuleSoft Anypoint Platform.
Bearer Token (OAuth 2.0)
- Header requerido:
  - Authorization: Bearer <access_token>
- El token debe ser obtenido desde el servicio corporativo de autenticación.
- El token debe estar vigente al momento de la solicitud.

Ambos mecanismos son requeridos para que la solicitud sea aceptada por la plataforma.

🔒 Aviso de Seguridad
Las credenciales (client_id, client_secret) y los tokens OAuth son información sensible y no deben compartirse ni almacenarse en repositorios públicos.

📍 Endpoints Disponibles

Método	Endpoint	Descripción
POST	`/payments/credit-card`	Realizar pago con tarjeta de crédito
POST	`/payments/pse`	Realizar pago por PSE
POST	`/payments/webcheckout`	Proceso de transacciones al gateway de pagos de PayU utilizando un formulario HTML

⚠️ Manejo de Errores

La API utiliza códigos HTTP estándar para indicar el resultado del procesamiento de las solicitudes.

Código	Estado	Descripción
200	OK	Solicitud procesada correctamente
400	Bad Request	Solicitud inválida o mal formada
401	Unauthorized	Credenciales inválidas o ausentes
403	Forbidden	Client ID sin permisos
404	Not Found	Recurso no encontrado
405	Method Not Allowed	Método HTTP no permitido
415	Unsupported Media Type	Tipo de contenido no soportado
429	Too Many Requests	Límite de solicitudes excedido
500	Internal Server Error	Error interno inesperado
503	Service Unavailable	Servicio temporalmente no disponible
504	Gateway Timeout	Tiempo de espera agotado

📞 Soporte

Para soporte técnico o incidencias relacionadas con la integración:

Coordinación de Servicios de Integración y Aplicaciones

📅 Información Adicional

Documentación creada en Febrero 2026 – Fundación Grupo Social – Colmena

home