Quickstart
Haz tu primera llamada exitosa a la API de Colurs en menos de 5 minutos.
Antes de empezar necesitas tus credenciales de Sandbox. Solicítalas en Colurs Panel en la sección de API Keys.
Pasos
1. Obtén tu token de acceso
Autentica con tus credenciales para recibir el par de tokens JWT.
curl -X POST https://dev.backend.colurs.co/token/ \
-H "Content-Type: application/json" \
-H "x-api-key: TU_API_KEY" \
-d '{
"email": "tu@empresa.com",
"password": "tu_password"
}'Respuesta exitosa:
{
"access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}El access token expira en 5 minutos. Guarda el refresh token
para renovarlo sin volver a hacer login.
2. Consulta el balance
Usa el access token para verificar que tu integración funciona correctamente.
curl -X GET https://dev.backend.colurs.co/balance/ \
-H "Authorization: Bearer TU_ACCESS_TOKEN" \
-H "x-api-key: TU_API_KEY" \
-H "Content-Type: application/json"Respuesta exitosa:
{
"COP": "0.00",
"USD": "0.00",
"MXN": "0.00"
}3. Renueva el token cuando expire
Antes de que el access token expire, renuévalo con el refresh token.
curl -X POST https://dev.backend.colurs.co/token/refresh/ \
-H "Content-Type: application/json" \
-H "x-api-key: TU_API_KEY" \
-d '{
"refresh": "TU_REFRESH_TOKEN"
}'Respuesta exitosa:
{
"access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}4. Explora el resto de la API
Ya tienes todo lo necesario para integrar cualquier flujo de Colurs.
Siguientes pasos recomendados
| Si quieres… | Ve a… |
|---|---|
| Registrar un usuario nuevo | Onboarding → Registro |
| Fondear una cuenta en Colombia | Fondeo → Recargas Colombia |
| Hacer un retiro bancario | Pagos → Retiros Bancarios |
| Convertir divisas | Intercambio → Exchange FX |
| Enviar dinero entre usuarios | Pagos → Envío entre usuarios |
Todos los ejemplos usan el entorno Sandbox (dev.backend.colurs.co).
Cuando pases a producción reemplaza la URL base por prod.colurs.co.