Documentation Index
Fetch the complete documentation index at: https://docs.cobrix.co/llms.txt
Use this file to discover all available pages before exploring further.
URL base
| Ambiente | URL |
|---|
| Staging | https://api-staging.cobrix.co |
| Producción | https://api.cobrix.co |
/api/external/payments.
Autenticación
Todos los endpoints requieren el header X-API-Key:
X-API-Key: sk_live_acme_PqL9Kx2Yj7mN...
Endpoints
Pagos
| Método | Endpoint | Descripción |
|---|
POST | /api/external/payments | Crear pago hosted (checkout) |
POST | /api/external/payments/direct | Crear pago directo (backend-to-backend) |
GET | /api/external/payments/{id} | Obtener un pago |
GET | /api/external/payments | Listar pagos (paginado) |
DELETE | /api/external/payments/{id} | Cancelar un pago pendiente |
Gestión de API Keys (admin, autenticación JWT)
| Método | Endpoint | Descripción |
|---|
POST | /api/companies/{companyId}/api-keys | Crear key |
GET | /api/companies/{companyId}/api-keys | Listar keys |
DELETE | /api/companies/{companyId}/api-keys/{keyId} | Revocar key |
POST | /api/companies/{companyId}/api-keys/{keyId}/rotate | Rotar key |
| Header | Requerido en | Descripción |
|---|
X-API-Key | Todos los endpoints de pagos | API key de la empresa |
Idempotency-Key | POST | UUID v4 único por operación |
Content-Type | POST | application/json |
Éxito
{
"id": "a1b2c3d4-...",
"status": "pending",
"mode": "hosted",
"amountMinor": 15000,
"currency": "VES",
"createdAt": "2026-03-26T14:30:00.000Z"
}
Error
{
"statusCode": 400,
"message": "Customer email must be a valid email",
"error": "Bad Request",
"timestamp": "2026-03-26T14:30:00.000Z",
"path": "/api/external/payments"
}
Paginación
GET /api/external/payments acepta page (default 1) y limit (default 20) y devuelve:
{
"payments": [ /* ... */ ],
"total": 42,
"page": 1,
"limit": 20
}
Rate limits
Cada API key tiene un límite de 60 requests/minuto por defecto (configurable). Cuando se excede, la API responde 429 Too Many Requests.
Unidades monetarias
Los montos se expresan siempre en la unidad mínima de la moneda. Ejemplos:
| Valor | Moneda | Equivalente |
|---|
10000 | VES | 100,00 VES |
5000 | USD | 50,00 USD |
10000 | CRC | 100,00 CRC |
VES, USD, CRC.
