Ambientes

Colurs tiene dos entornos disponibles: Sandbox para desarrollo y pruebas, y Producción para operaciones reales.

Comparativa

Característica	Sandbox	Producción
URL base	`https://dev.backend.colurs.co`	`https://prod.colurs.co`
Transacciones reales	❌ No	✅ Sí
Credenciales	API Key de desarrollo	API Key de producción
Datos	Ficticios / de prueba	Reales

Sandbox

Entorno seguro para desarrollar y probar tu integración sin riesgo.

⚠️

El Sandbox no procesa dinero real. Úsalo para validar todos tus flujos antes de pasar a producción.

Cómo acceder:

Solicita tus credenciales de Sandbox por este canal Click Aqui
Usa https://dev.backend.colurs.co como URL base en todas tus peticiones
Incluye tu API Key de desarrollo en el header x-api-key

Producción

Entorno real donde se procesan operaciones con dinero real.

Para acceder a Producción debes haber completado el onboarding empresarial con el equipo de Colurs. Agenda una demo.

Checklist antes de pasar a Producción

Todos los flujos probados y validados en Sandbox
Manejo de errores implementado para códigos 400, 401, 403 y 500
Renovación automática del access_token implementada en tu cliente
Webhook handlers configurados para recibir eventos de la plataforma
Credenciales de Producción solicitadas y recibidas
URL base actualizada a https://prod.colurs.co
Variables de entorno configuradas (no hardcodear API Keys)

Headers requeridos en ambos entornos

Content-Type: application/json
Accept: application/json
x-api-key: TU_API_KEY
Authorization: Bearer TU_ACCESS_TOKEN

💡

Tip: Usa una variable de entorno COLURS_BASE_URL para alternar entre Sandbox y Producción con un solo cambio de configuración.

Quickstart Cómo autenticarse