cs-nequi-sapi
Esta API permite el procesamiento y la gestión de pagos no registrados, incluyendo la iniciación de pagos, la verificación de estado, las reversiones y las cancelaciones para transacciones de Nequi.
home
🛡️cs-nequi-sapi
Esta API de Sistema procesa pagos usando Nequi. Soporta operaciones como enviar pagos, consultar su estado, reversar transacciones y cancelar pagos de usuarios no registrados.
🌐 Información Base
- Título de la API: cs-nequi-sapi
- Versión: 1.0.0
- URL Base:
https://cs-nequi-sapi-prod.us-e1.cloudhub.io/api
🚀 Primeros Pasos
- Autenticación: Requiere un
client_id
válido y un tokenOAuth 2.0 Bearer
. - URL Base: Utiliza la URL Base proporcionada para todas las solicitudes a los endpoints.
Encabezados: Asegúrate de incluir los siguientes encabezados:
client_id: TU_CLIENT_ID
Authorization: Bearer TU_ACCESS_TOKEN
Content-Type: application/json
📍 Endpoints Disponibles
📌 Pagos - Usuarios No Registrados
Método | Endpoint | Descripción | Enlace Exchange |
---|---|---|---|
POST | /payments/unregistered | Inicia un pago para un usuario no registrado. | Ver detalles |
POST | /payments/unregistered/status | Consulta el estado de un pago no registrado. | Ver detalles |
POST | /payments/unregistered/reverse | Reversa un pago no registrado. | Ver detalles |
POST | /payments/unregistered/cancel | Cancela un pago no registrado. | Ver detalles |
📤 Ejemplo de Solicitud
curl -X POST "<endpoint>" \
-H "client_id: TU_CLIENT_ID" \
-H "Authorization: Bearer TU_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "key": "value" }'
Reemplaza <endpoint>
y el cuerpo (payload
) con el recurso y los datos apropiados.
📊 Diagrama de Componentes
Este diagrama muestra la arquitectura general y los componentes involucrados en la integración de cs-nequi-sapi
:
⚠️ Manejo de Errores
Se utilizan los códigos de estado HTTP estándar para el manejo de errores:
200 OK
– La solicitud fue exitosa400 Bad Request
– Parámetros faltantes o inválidos401 Unauthorized
– Error de autenticación404 Not Found
– Endpoint o recurso no encontrado500 Internal Server Error
– Error inesperado en el servidor
📞 Soporte
Para cualquier inconveniente, por favor contacta al equipo de soporte de la API:
Coordinación de Servicios de Integración y Aplicaciones
📅 Notas
- Documentación actualizada por última vez: Septiembre 2025
- Para futuras actualizaciones, consulta el Portal de API Exchange