Códigos de error

Referencia completa de los errores que puede retornar la API Colurs.

Errores de autenticación

Código	Error	Descripción
400	Bad Request	Parámetros inválidos o faltantes en la petición
401	Unauthorized	Token inválido, expirado o no enviado
403	Forbidden	Sin permisos para ejecutar esta operación
404	Not Found	Recurso no encontrado
429	Too Many Requests	Límite de peticiones excedido
500	Internal Server Error	Error interno del servidor

Errores por módulo

Autenticación

Código	Error	Descripción
400	DataInvalidException	Credenciales inválidas o plataforma no válida
400	CodeMustBeRequiredException	Código requerido para PANEL/IOS/ANDROID
400	CodeExpiredException	Código de verificación expirado
400	OTPRequiredException	Se requiere código 2FA (usuario tiene MFA)
400	InvalidOTPException	Código 2FA inválido

Usuarios

Código	Error	Descripción
400	InvalidReferrer	Código de referido inválido
400	ProfileAlreadyReferred	El perfil ya tiene un referido asignado
404	ReferalCodeNotExist	El código de referido no existe
400	TypePersonRequired	Tipo de persona requerido
400	InfoBusinessDoesNotExist	Información de negocio no existe
400	IntegrationException	Error en integración externa

Retiros

Código	Error	Descripción
400	BalanceInsufficient	Balance insuficiente para el retiro
400	InvalidCurrencyForQuoteWithDraw	Moneda inválida para el país
400	MarketPlaceUserRequired	Se requiere wallet activa
404	BankAccountNotFound	Cuenta bancaria no encontrada
422	UnsupportedBankName	Banco no soportado
422	UnsupportedDocumentType	Tipo de documento no válido

Payment Links

Código	Error	Descripción
400	AmountRequired	Monto requerido para links generales
400	AmountMismatch	Monto no coincide con el del link
400	InvalidStatus	El link no está en estado válido para pago
404	NotFound	Payment Link no existe

Todos los errores retornan un cuerpo JSON con el campo detail o message describiendo la causa del error.

Índice de referencia Webhooks