> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Códigos de error generales de la API
Estos códigos de error son consistentes en toda nuestra API.
| Error | Código | Mensaje de error |
| ------------------------------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| INVALID\_ACCOUNT | AUTH-0001 | Tu cuenta no tiene los permisos adecuados para iniciar sesión en este portal. Solicita una Cuenta Enterprise. |
| INVALID\_CREDENTIALS | AUTH-0002 | Detalles de autenticación incorrectos. |
| PHONE\_NUMBER\_NOT\_FOUND | AUTH-0003 | No se pudo encontrar el número de teléfono proporcionado o el número de teléfono no está verificado. Selecciona un método diferente o contacta al soporte al cliente. |
| INVALID\_PHONE\_NUMBER | AUTH-0004 | Número de teléfono inválido. |
| INVALID\_2FA\_TOKEN | AUTH-0005 | Acceso denegado o expirado. |
| INCORRECT\_AUTH\_CODE | AUTH-0006 | El código de autenticación proporcionado es incorrecto, verifica y vuelve a ingresar el código recibido e inténtalo de nuevo. |
| UNABLE\_TO\_SEND\_AUTH\_CODE | AUTH-0007 | No pudimos enviar el código de autenticación, inténtalo nuevamente o contacta al soporte al cliente. |
| INVALID\_USER\_ACCESS | AUTH-0008 | Acceso de usuario inválido. |
| INVALID\_PASSWORD | AUTH-0009 | La contraseña proporcionada no es válida. |
| NO\_PIN\_EXISTS | AUTH-0010 | No hay un código de acceso establecido para el usuario; en su lugar, crea uno. |
| PIN\_ALREADY\_SET | AUTH-0011 | Ya hay un código de acceso establecido para el usuario; en su lugar, restablécelo. |
| INVALID\_PIN\_CODE | AUTH-0012 | El código de acceso proporcionado no coincide con nuestros registros; inténtalo nuevamente o restablece tu código de acceso. |
| SOCIAL\_UNABLE\_TO\_LOGIN | AUTH-0013 | No se puede iniciar sesión con tu cuenta social. Verifica tus credenciales e inténtalo de nuevo o contacta al soporte al cliente. |
| UNABLE\_TO\_CREATE\_PIN | AUTH-0014 | No se puede crear un nuevo código de acceso; inténtalo nuevamente o contacta al soporte al cliente. |
| UNABLE\_TO\_CHECK\_PIN | AUTH-0015 | No se puede verificar el código de acceso; inténtalo nuevamente o contacta al soporte al cliente. |
| UNABLE\_TO\_UPDATE\_PIN | AUTH-0016 | No se puede actualizar el código de acceso; inténtalo nuevamente o contacta al soporte al cliente. |
| UNABLE\_TO\_RESET\_PIN | AUTH-0017 | No se puede restablecer el código de acceso; inténtalo nuevamente o contacta al soporte al cliente. |
| TRADITIONAL\_UNABLE\_TO\_LOGIN | AUTH-0018 | No se puede iniciar sesión con tu cuenta. Verifica tus credenciales e inténtalo de nuevo o contacta al soporte al cliente. |
| INVALID\_JWT | AUTH-0019 | ¡Token JWT inválido! |
| UNABLE\_TO\_RESEND\_2FA | AUTH-0020 | ¡No se puede reenviar el 2FA! |
| UNSUPPORTED\_PHONE\_NUMBER | AUTH-0021 | El número proporcionado no es un número de teléfono móvil válido. Ponte en contacto con soporte para más detalles. |
| REGISTRATION\_NOT\_ALLOWED | AUTH-0022 | Registro no permitido; por favor, contacta al soporte al cliente. |
| UNABLE\_TO\_CHANGE\_PASSWORD | AUTH-0023 | No se puede cambiar la contraseña. Inténtalo nuevamente o contacta al soporte al cliente. |
| UNVERIFIED\_PHONE\_NUMBER | AUTH-0024 | Tu número de teléfono requiere verificación. Por favor, contacta al soporte. |
| UNSUCCESSFUL\_REGISTRATION | AUTH-0025 | Inténtalo nuevamente o contacta al soporte. |
| REGISTRATION\_PHONE\_TAKEN | AUTH-0026 | El número de teléfono que elegiste ya está en uso. |
| REGISTRATION\_EMAIL\_TAKEN | AUTH-0027 | La dirección de correo electrónico que elegiste ya está en uso. |
| UNABLE\_TO\_RESET\_PASSWORD | AUTH-0028 | No se puede restablecer la contraseña. |
| SECURITY\_CODE\_EXPIRED | AUTH-0029 | Tu código de seguridad de 6 dígitos ha expirado. Vuelve a enviar un código nuevo. |
| APPLICATION\_INACTIVE | AUTH-0030 | Tu aplicación no está activa. |
| INVALID\_SCOPE | AUTH-0031 | Los alcances solicitados deben ser otorgados por el usuario primero. |
## Errores de dirección
Los campos de dirección se validan en varios flujos. Las restricciones difieren según el contexto (por ejemplo, las direcciones de tarjeta virtual y cuenta bancaria son solo de EE. UU., mientras que las direcciones legales comerciales pueden ser internacionales). Para reglas de formato y ejemplos prácticos, consulta [Requisitos de formato de direcciones](/concepts/address-formatting-requirements).
| Error | Código | Aplica a | Mensaje de error |
| --------------------------- | ------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| INVALID\_BILLING\_ADDRESS | VC-0025 | Emisión de tarjeta virtual (dirección de facturación) | No se pudo verificar la dirección de facturación. Debe ser una dirección de EE. UU. entregable (sin apartados postales) con ciudad, estado y código ZIP coincidentes. |
| InvalidBusinessLegalAddress | BS-0002 | Registro de negocio (KYB) | La dirección legal del negocio es incorrecta. |
| InvalidOwnerInformation | BS-0003 | Registro de negocio (KYB) | Uno o más datos del propietario son incorrectos (incluye la dirección del propietario en EE. UU.). |
**Campos de dirección faltantes o mal formados**
Un campo obligatorio faltante o un valor inválido dentro de un objeto de dirección se devuelve como un error general de argumentos — `ARG-0001` en llamadas de tarjeta virtual, o `AR-0001` / `AR-0002` en registro de negocio — en lugar de uno de los códigos de dirección anteriores.
## Próximos pasos
La forma del sobre de error, prefijos de dominio y cómo solucionar problemas con IDs de solicitud.
Reglas de formato y ejemplos prácticos para evitar los errores de dirección anteriores.
¿Quieres saber más? Contáctanos en [partnerships@fluz.app](mailto:partnerships@fluz.app). Habla con nuestros expertos para más información o para solicitar una demo.