Catálogo de errores

Todos los códigos de error de negocio que pueden devolver las APIs Gateway y CMS de Migo. Los códigos son strings en el rango 7000–8099 y se devuelven en el arreglo errors[] del envelope CustomResponse:

{
  "success": false,
  "message": "Optional human-readable summary",
  "errors": [{ "code": "7200", "message": "Card not found in the system." }]
}

El status HTTP se deriva del código en el interceptor de respuesta del gateway, con este orden de precedencia: 500 (interno) → 404 (no encontrado) → 400 (solicitud inválida) → 401 (no autenticado) → 403 (prohibido) → 409 (conflicto). Un código no clasificado en ningún conjunto usa 500 por defecto.

Fuente de verdad

Este catálogo se genera a partir de MigoCodeErrors y MigoErrorMessages en @migo-payments/ali-common-tl (src/errors/error.enum.ts y src/errors/error.ts). La columna Mensaje muestra la traducción al español; la API devuelve estas cadenas en inglés.

Generales y parámetros (`7000–7099`)

Código	Nombre	HTTP	Mensaje
`7000`	`CHECK_PARAMETERS`	400	Verifica los parámetros proporcionados.
`7001`	`GREATER_THAN_ZERO`	400	El monto debe ser mayor que cero.
`7002`	`INVALID_FORMAT_AMOUNT`	400	Formato de monto inválido.
`7003`	`CONSULT_WITH_SUPPORT`	500	Contacta a soporte para recibir asistencia.
`7004`	`SERVICES_NOT_FOUND`	404	Servicios requeridos no encontrados.
`7005`	`PROCESSOR_NOT_FOUND`	404	Procesador de pago no encontrado.
`7006`	`EXTERNAL_ID_ALREADY_EXISTS`	409	El ID externo ya existe.
`7007`	`ERROR_GETTING_ACTIONS`	500	Error al obtener las acciones.
`7008`	`ERROR_DATE_RTU`	500	La fecha RTU (actualización en tiempo real) es inválida. La fecha de actualización debe estar dentro de los últimos 6 meses a partir de la fecha actual.
`7009`	`ERROR_CAN_INVOICE_PARAM`	500	Error con los parámetros de facturación.
`7010`	`NOT_FOUND`	404	No encontrado, verifica el endpoint
`7011`	`ERROR_CREATE_TERMINAL_PROCESSOR`	500	Error al crear el procesador de terminal, verifica los datos e inténtalo de nuevo.
`7012`	`ERROR_UPDATE_TERMINAL_PROCESSOR`	500	Error al actualizar el procesador de terminal, verifica los datos e inténtalo de nuevo.
`7013`	`TERMINAL_PROCESSOR_NOT_FOUND`	404	Procesador de terminal no encontrado
`7014`	`TERMINAL_PROCESSOR_EMPTY`	404	La terminal no tiene un procesador de terminal
`7015`	`TERMINAL_PROCESSOR_ALREADY_EXISTS`	409	El procesador de terminal ya existe
`7016`	`TERMINAL_PROCESSOR_INACTIVE`	409	El procesador de terminal está inactivo; si deseas activarlo, contacta a soporte.

Usuarios, autenticación y OTP (`7100–7199`)

Código	Nombre	HTTP	Mensaje
`7100`	`USER_NOT_FOUND`	404	Usuario no encontrado en el sistema.
`7101`	`USER_ALREDY_EXIST`	409	El usuario ya existe en el sistema, verifica tu nombre de usuario.
`7102`	`USER_DOCUMENT_NOT_FOUND`	404	Documento de usuario no encontrado.
`7103`	`ERROR_CREATE_USER_DOCUMENT`	500	Error al crear el documento de usuario.
`7104`	`ERROR_READ_USER_FILE`	500	Error al leer el archivo de usuario.
`7105`	`ERROR_CREATE_LEAD`	500	Error al crear el lead.
`7106`	`ERROR_FIND_USER_BY_DOCUMENT`	500	Error al buscar usuario por documento.
`7107`	`VERIFY_DOCUMENT_TYPE`	400	Verifica el tipo de documento.
`7108`	`ACCOUNT_NOT_FOUND`	404	Cuenta no encontrada en el sistema.
`7109`	`ERROR_CREATING_NEW_ACCOUNT`	500	Error al crear la nueva cuenta.
`7110`	`ERROR_CREATING_INVITATION_CODE`	500	Ocurrió un error al crear el código de invitación, verifica el estado de la sucursal
`7111`	`ERROR_PASSWORD_NOT_MATCH`	400	Las contraseñas no coinciden, verifica e inténtalo de nuevo.
`7112`	`ERROR_MIN_LENGTH_PASSWORD`	400	Verifica que la longitud de la cadena tenga el número de caracteres indicado.
`7113`	`ERROR_LOWERCASE_PASSWORD`	400	Verifica que la cadena contenga al menos una letra minúscula.
`7114`	`ERROR_UPPERCASE_PASSWORD`	400	Verifica que la cadena contenga al menos una letra mayúscula.
`7115`	`ERROR_AT_LEAST_NUMBER_PASSWORD`	400	Verifica que la cadena contenga al menos un número.
`7116`	`ERROR_AT_LEAST_SYMBOL_PASSWORD`	400	Verifica que la cadena contenga al menos un carácter especial.
`7117`	`INVALID_PASSWORD`	400	Contraseña inválida, verifica e inténtalo de nuevo.
`7118`	`ERROR_CREATING_USER`	500	Error al crear el usuario, contacta a soporte.
`7119`	`ERROR_PREVIOUS_PASSWORD`	409	No puedes reutilizar una contraseña anterior, intenta con una nueva.
`7120`	`NOT_FOUND_INVITATION_CODE`	404	Código de invitación no encontrado, verifica tu código e inténtalo de nuevo.
`7121`	`LEAD_ALREADY_REGISTERED`	409	El lead ya está registrado, obtén un nuevo código de invitación.
`7122`	`TERMS_AND_CONDITIONS_NOT_ACCEPTED`	400	Acepta los términos y condiciones para continuar.
`7123`	`DOCUMENT_ALREADY_EXIST`	409	El documento ya existe, verifícalo.
`7124`	`ERROR_FINDING_USER`	500	Error al buscar el usuario, verifica tu userId e inténtalo de nuevo.
`7125`	`ERROR_CREATING_USER_APPLICATION`	500	Error al crear la aplicación del usuario, contacta a soporte.
`7126`	`ERROR_CREATING_AUTH_USER`	500	Error al crear el usuario de autenticación, contacta a soporte.
`7127`	`ERROR_USER_IS_ACCOUNT`	400	El usuario es una cuenta, acceso denegado.
`7128`	`USERNAME_NOT_FOUND`	404	Usuario no encontrado, verifica tu nombre de usuario e inténtalo de nuevo.
`7129`	`APPLICATION_USER_NOT_FOUND`	404	Usuario de aplicación no encontrado, verifica tu usuario e inténtalo de nuevo.
`7130`	`LEAD_NOT_FOUND`	404	Lead no encontrado, verifica la información del lead e inténtalo de nuevo.
`7131`	`INVALID_OTP_PURPOSE`	400	Propósito de OTP inválido, verifica el propósito e inténtalo de nuevo.
`7132`	`INVALID_OTP`	401	OTP inválido, verifica el OTP e inténtalo de nuevo.
`7133`	`OTP_NOT_FOUND`	404	OTP no encontrado, verifica el OTP e inténtalo de nuevo.
`7134`	`OTP_ALREADY_USED`	409	El OTP ya fue utilizado, solicita un nuevo OTP.
`7135`	`OTP_EXPIRED`	400	El OTP ha expirado, solicita un nuevo OTP.
`7136`	`OTP_REQUEST_FAILED`	400	No se pudo solicitar el OTP, inténtalo más tarde.
`7137`	`ERROR_VALIDATING_USER`	500	Error al validar el usuario, contacta a soporte.
`7138`	`ERROR_ACCESS_LOGIN`	500	Ocurrió un error al iniciar sesión, inténtalo más tarde.
`7139`	`USER_SUSPENDED`	403	Has superado el número de intentos de inicio de sesión, tu usuario ha sido suspendido temporalmente
`7140`	`ERROR_FINDING_SUSPENSION`	500	Error al buscar la suspensión, verifica el ms de usuarios
`7141`	`ERROR_CREATING_SUSPENSION`	500	Error al crear la suspensión, verifica el ms de usuarios
`7142`	`ERROR_LOGOUT`	500	Error al cerrar sesión, verifica tu token
`7143`	`UNAUTHORIZED_ACCESS_USER`	401	Acceso de usuario no autorizado, verifica tus credenciales.
`7144`	`FORBIDDEN_ACCESS_USER`	403	Tu usuario no tiene permiso para acceder a este recurso
`7145`	`INVALID_USER_ACCESS_TOKEN`	500	Token de acceso de usuario inválido, verifica tu token
`7146`	`INVALID_USER_REFRESH_TOKEN`	500	Token de actualización de usuario inválido, verifica tu refresh token
`7147`	`INVALID_USER_SIGNATURE`	401	Firma de usuario inválida, verifica tu token
`7148`	`EXPIRED_USER_TOKEN`	400	Token de usuario expirado, usa el refresh token o inicia sesión de nuevo.
`7149`	`EXPIRED_USER_REFRESH_TOKEN`	400	Refresh token de usuario expirado, inicia sesión de nuevo.
`7150`	`ERROR_CREATING_AUTH_USER_ROLE`	500	Error al crear el rol del usuario de autenticación, contacta a soporte.
`7151`	`ERROR_CREATING_AUTH_USER_PERMISSION`	500	Error al crear el permiso del usuario de autenticación, contacta a soporte.
`7152`	`ERROR_UPDATING_AUTH_USER_PERMISSION`	500	Error al actualizar el permiso del usuario de autenticación, contacta a soporte.
`7153`	`ERROR_UPDATING_AUTH_USER_ROLE`	500	Error al actualizar el rol del usuario de autenticación, contacta a soporte.
`7154`	`ERROR_FINDING_AUTH_USER_ROLE`	500	Error al buscar el rol del usuario de autenticación, contacta a soporte.
`7155`	`ERROR_FINDING_AUTH_USER_PERMISSION`	500	Error al buscar el permiso del usuario de autenticación, contacta a soporte.
`7156`	`AUTH_USER_ROLE_NOT_FOUND`	404	Rol de usuario de autenticación no encontrado, verifica los nombres
`7157`	`AUTH_USER_PERMISSION_NOT_FOUND`	404	Permiso de usuario de autenticación no encontrado, verifica los nombres
`7158`	`ROLE_ALREADY_EXIST`	409	El rol ya existe, verifica los roles
`7159`	`USER_PERMISSION_ALREADY_EXIST`	409	El permiso de usuario ya existe, verifica los datos e inténtalo de nuevo.
`7160`	`ERROR_REGISTERING_FCM_TOKEN`	500	Error al registrar el token FCM, verifica los datos e inténtalo de nuevo.
`7161`	`ERROR_REMOVING_FCM_TOKEN`	500	Error al eliminar el token FCM, verifica los datos e inténtalo de nuevo.
`7162`	`INVALID_REGISTRATION_TOKEN`	400	Token de registro inválido, verifica los datos e inténtalo de nuevo.
`7163`	`FCM_TOKEN_NOT_FOUND`	404	Token FCM no encontrado, renueva el token del dispositivo
`7164`	`ERROR_UPDATING_USER_PASSWORD`	500	Error al actualizar la contraseña del usuario, verifica los datos e inténtalo de nuevo.
`7165`	`PASSWORD_NOT_PROVIDED`	500	No se proporcionó una contraseña, proporciona una contraseña.
`7166`	`PASSWORDS_DO_NOT_MATCH`	500	Las contraseñas no coinciden, verifica e inténtalo de nuevo.
`7167`	`ERROR_UPLOADING_PROFILE_IMAGE`	400	Error al subir la imagen de perfil, inténtalo más tarde.
`7168`	`ERROR_GETTING_USER_PROFILE`	400	Error al obtener el perfil del usuario, verifica tu userId e inténtalo de nuevo.
`7169`	`ERROR_UPDATING_USER_PROFILE`	500	Error al actualizar el perfil del usuario, inténtalo más tarde.
`7170`	`ERROR_FETCHING_PROFILE_DATA`	500	Error al obtener los datos del perfil, inténtalo más tarde.
`7171`	`INVALID_USER_STATUS`	409	El estado del usuario es inválido; si deseas activarlo, contacta a soporte.
`7172`	`EXPIRED_USER_PASSWORD`	409	La contraseña del usuario ha expirado, restablécela e inténtalo de nuevo.
`7173`	`SDK_NOT_VALID`	500	SDK inválido.

Tarjetas (`7200–7299`)

Código	Nombre	HTTP	Mensaje
`7200`	`CARD_NOT_FOUND`	404	Tarjeta no encontrada en el sistema.
`7201`	`INVALID_CARD_ACCESS`	400	Acceso a la tarjeta no autorizado. Verifica la información ingresada.
`7202`	`ALREADY_ACTIVED`	409	La tarjeta ya está activada.
`7203`	`ALREADY_BLOCKED`	409	La tarjeta ya está bloqueada.
`7204`	`ALREADY_UNLOCKED`	409	La tarjeta ya está desbloqueada.
`7205`	`INCORRECT_PIN`	400	PIN ingresado incorrecto.
`7206`	`CARD_EXPIRED`	400	La tarjeta ha expirado.
`7207`	`CARD_NOT_CREATED`	500	Error al crear la tarjeta.
`7208`	`CARD_ALREADY_ASSIGNED`	409	La tarjeta ya está asignada a un usuario.
`7209`	`CARD_ALREADY_LINKED`	409	La tarjeta ya está vinculada a una cuenta.
`7210`	`CARD_NOT_UPDATED`	500	Error al actualizar la información de la tarjeta.
`7211`	`ERROR_CREATING_CARD`	500	Error al crear la tarjeta.
`7212`	`CARDS_NOT_FOUND`	404	El usuario no tiene tarjetas.
`7213`	`INVALID_STATUS_CARD`	400	El estado de la tarjeta es inválido. Verifica que tu tarjeta esté activa
`7214`	`ERROR_GETTING_CARD`	500	Error al obtener la tarjeta, verifica tu cardId e inténtalo de nuevo.
`7215`	`ERROR_GETTING_USER_CARDS`	500	Error al obtener las tarjetas del usuario, verifica tu userId e inténtalo de nuevo.
`7216`	`ERROR_CREATING_CARD_USER_PERMISSION`	500	Error al crear el permiso de usuario de la tarjeta, verifica los ids y nombres e inténtalo de nuevo.
`7217`	`ERROR_UPDATING_CARD_USER_PERMISSION`	500	Error al actualizar el permiso de usuario de la tarjeta, verifica los ids y nombres e inténtalo de nuevo.
`7218`	`ERROR_FINDING_CARD_USER_PERMISSION`	500	Error al buscar el permiso de usuario de la tarjeta, verifica los ids y nombres e inténtalo de nuevo.
`7219`	`CARD_USER_PERMISSION_NOT_FOUND`	404	Permiso de usuario de la tarjeta no encontrado, verifica los ids y nombres e inténtalo de nuevo.
`7220`	`THIRD_PARTY_CARD_NOT_FOUND`	404	Tarjeta de terceros no encontrada, verifica el sufijo, nombre de usuario o id e inténtalo de nuevo.
`7221`	`ERROR_CREATING_THIRD_PARTY_CARD`	500	Error al crear la tarjeta de terceros, verifica los datos e inténtalo de nuevo.
`7222`	`THIRD_PARTY_CARD_ALREADY_ASSIGNED`	409	La tarjeta de terceros ya existe, verifica el sufijo y el nombre de usuario e inténtalo de nuevo.
`7223`	`CARD_ASSOCIATED_BELONGS_TO_THE_USER_WHO_MADE_THE_REQUEST`	409	No puedes asociar tarjetas que ya pertenecen al usuario
`7224`	`ERROR_CREATING_VIEW_TOKEN`	500	Error al crear el view token, verifica los datos e inténtalo de nuevo.
`7225`	`VIEW_TOKEN_NOT_FOUND`	404	View token no encontrado, verifica los datos e inténtalo de nuevo.
`7226`	`ERROR_UNLINKED_THIRD_PARTY_CARD`	500	Error al desvincular la tarjeta de terceros, verifica los datos e inténtalo de nuevo.
`7227`	`ERROR_UPDATING_THIRD_PARTY_CARD`	500	Error al actualizar la tarjeta de terceros, verifica los datos e inténtalo de nuevo.

Transferencias y pagos (`7300–7399`)

Código	Nombre	HTTP	Mensaje
`7300`	`ERROR_CREATING_TRANSFER`	500	Error al crear la transferencia.
`7301`	`ERROR_UPDATING_TRANSFER`	500	Error al actualizar la transferencia.
`7302`	`ERROR_GETTING_HISTORY`	500	Error al obtener el historial de transacciones.
`7303`	`INSUFFICIENT_FUNDS`	400	Fondos insuficientes para completar la transacción.
`7304`	`INVALID_TRANSFER_STATUS`	400	Estado de transferencia inválido.
`7305`	`ERROR_CREATING_TRANSFER_TYPE`	500	Error al crear el tipo de transferencia.
`7306`	`CARD_TRANSFER_NOT_FOUND`	404	Transferencia de tarjeta no encontrada.
`7307`	`ERROR_CREATING_TERMINAL_PAYMENT`	500	Error al crear el pago de terminal.
`7308`	`ERROR_TERMINAL_PAYMENT_STATUS`	500	Error al obtener el estado del pago de terminal.
`7309`	`ERROR_UPDATING_TERMINAL_PAYMENT`	500	Error al actualizar el pago de terminal.
`7310`	`CARD_TRANSFER_DATE_NOT_VALID`	403	La solicitud ya no es válida porque debe completarse dentro del mismo día calendario.
`7311`	`TOPUP_REASON_TOO_LONG`	400	El motivo de la recarga es demasiado largo.

Terminales, negocios y sucursales (`7400–7499`)

Código	Nombre	HTTP	Mensaje
`7400`	`TERMINAL_NOT_FOUND`	404	Terminal no encontrada.
`7401`	`TERMINAL_INACTIVE`	400	La terminal está inactiva.
`7402`	`TERMINAL_PAYMENT_NOT_FOUND`	404	Pago de terminal no encontrado.
`7403`	`ERROR_CREATING_TERMINAL`	500	Error al crear la terminal.
`7404`	`ERROR_UPDATING_TERMINAL`	500	Error al actualizar la terminal.
`7405`	`ERROR_CREATING_COMMERCE_CONFIG`	500	Error al crear la configuración del comercio.
`7406`	`ERROR_CREATING_COMMERCE`	500	Error al crear el comercio.
`7407`	`COMMERCE_OR_USER_NOT_FOUND`	404	Comercio o usuario no encontrado.
`7408`	`BUSINESS_NOT_FOUND`	404	Negocio no encontrado.
`7409`	`ERROR_CREATING_BRANCH`	500	Error al crear la sucursal, contacta a soporte.
`7410`	`BRANCH_NOT_FOUND`	404	Sucursal no encontrada
`7411`	`ERROR_CREATING_BRANCH_ACCOUNT`	500	Ocurrió un error al crear la cuenta de la sucursal, verifica el estado de la sucursal y la existencia de la cuenta
`7412`	`BRANCH_ACCOUNT_NOT_FOUND`	404	Cuenta de la sucursal no encontrada, verifica el estado de la sucursal
`7413`	`TERMINAL_ALREADY_LINKED`	409	La terminal ya está vinculada, obtén una nueva terminal.
`7414`	`BUSINESS_ALREADY_EXISTS`	409	El negocio ya existe, verifica los datos e inténtalo de nuevo.
`7415`	`BRANCH_ALREADY_EXISTS`	409	La sucursal ya existe, verifica los datos e inténtalo de nuevo.
`7416`	`BRANCH_AUTH_USER_NOT_FOUND`	404	El AuthUserId proporcionado no existe en el usuario de autenticación de la sucursal, verifica la información.
`7417`	`BRANCH_AUTH_USER_OWNER_NOT_FOUND`	404	La sucursal proporcionada no tiene propietario, verifica la información.
`7418`	`ERROR_FINDING_BRANCH_AUTH_USER`	500	Error al obtener el usuario de autenticación de la sucursal, contacta a soporte.
`7419`	`TERMINAID_OR_DEVICEID_ARE_MISSING`	400	Falta el ID de terminal o el ID de dispositivo, verifica los datos e inténtalo de nuevo.

Liquidaciones y régimen (`7500–7599`)

Código	Nombre	HTTP	Mensaje
`7500`	`ERROR_CREATING_SETTLEMENT`	500	Error al crear la liquidación.
`7501`	`SETTLEMENT_NOT_FOUND`	404	Liquidación no encontrada.
`7502`	`ERROR_UPDATING_SETTLEMENT`	500	Error al actualizar la liquidación.
`7503`	`REGIME_NOT_VALID`	500	Régimen fiscal inválido.
`7504`	`REGIME_NOT_FOUND`	404	Régimen fiscal no encontrado.
`7505`	`ERROR_CREATING_REGIME`	500	Error al crear el régimen fiscal.
`7506`	`ERROR_CREATING_ACCOUNT_CHANGE`	500	Error al crear el cambio de cuenta.
`7507`	`DUPLICATE_SETTLEMENT`	500	Ya existe una liquidación para el pago de terminal actual
`7508`	`CONFIG_NOT_FOUND`	404	Configuración no encontrada
`7509`	`CALLBACK_NOT_FOUND`	404	Callback no encontrado, verifica los datos e inténtalo de nuevo.
`7510`	`ERROR_GETTING_UNSETTLED_TERMINAL_PAYMENTS`	500	Error al obtener los pagos de terminal no liquidados, verifica los datos e inténtalo de nuevo.

Clientes, roles, permisos y archivos (`7600–7699`)

Código	Nombre	HTTP	Mensaje
`7600`	`ERROR_CREATING_CLIENT`	500	Error al crear el cliente, contacta a soporte.
`7601`	`ERROR_AUTHENTICATION_FAILED`	500	La autenticación falló, verifica tus credenciales.
`7602`	`UNAUTHORIZED_ACCESS`	401	Acceso no autorizado, verifica tus credenciales.
`7603`	`EXPIRED_TOKEN`	400	Token expirado, usa el refresh token o inicia sesión de nuevo.
`7604`	`INVALID_SIGNATURE`	401	Firma inválida, verifica tu token.
`7605`	`INVALID_REFRESH_TOKEN`	400	Refresh token inválido, inicia sesión de nuevo.
`7606`	`INVALID_ACCESS_TOKEN`	400	Token de acceso inválido, verifica tu token.
`7607`	`CLIENT_NOT_FOUND`	404	Cliente no encontrado, verifica tu comercio.
`7608`	`ERRROR_CREATING_PERMISSION`	500	Sin mensaje registrado — usa el fallback `7003` (contactar a soporte).
`7609`	`ERROR_CREATING_ROLE`	500	Error al crear el rol, contacta a soporte.
`7610`	`ERROR_CREATING_ROLE_PERMISSION`	500	Error al crear el permiso del rol, contacta a soporte.
`7611`	`ROLES_NOT_FOUND`	404	Uno o más roles no encontrados, verifica los nombres.
`7612`	`PERMISSIONS_NOT_FOUND`	404	Uno o más permisos no encontrados, verifica los nombres.
`7613`	`ROLE_PERMISSIONS_NOT_FOUND`	404	Permisos del rol no encontrados, contacta a soporte.
`7614`	`CLIENT_ROLE_NOT_FOUND`	404	Rol del cliente no encontrado, contacta a soporte.
`7615`	`CLIENT_ROLE_FORBIDDEN`	403	No tienes permiso para acceder a este recurso.
`7616`	`KEYS_EXPIRED`	400	Las llaves han expirado, rótalas.
`7617`	`ERROR_UPDATING_ROLE`	500	Error al actualizar el rol, contacta a soporte.
`7618`	`INVALID_SIGNATURE_KEYS`	400	Las llaves de firma son inválidas, rota las llaves e inicia sesión de nuevo.
`7619`	`ERROR_UPLOADING_FILE`	500	Error al subir el archivo, inténtalo más tarde.
`7620`	`INVALID_FILE_TYPE`	500	Tipo de archivo inválido, sube un archivo válido.
`7621`	`NO_SOCIALS_PROVIDED`	400	No se proporcionaron enlaces de redes sociales, proporciona al menos uno.
`7622`	`INVALID_SOCIAL_URL`	400	URL de red social inválida, verifica el formato de la URL.
`7623`	`ERROR_UPLOADING_SOCIALS`	400	Error al subir los enlaces de redes sociales, inténtalo más tarde.
`7624`	`ERROR_SAVING_SOCIALS`	500	Error al guardar los enlaces de redes sociales, inténtalo más tarde.
`7625`	`ERROR_FETCHING_COMMERCE_DOCS`	500	Error al obtener los documentos del comercio, inténtalo más tarde.
`7626`	`MONTH_INVALID`	400	El mes es inválido. Debe ser un valor entre 01 y 12.
`7627`	`YEAR_INVALID`	400	El año es inválido. Debe ser un año válido.
`7628`	`FILE_SIZE_LIMIT_EXCEEDED`	400	El tamaño del archivo excede el límite máximo permitido de 16 MB.
`7629`	`INVALID_EXCEL_FILE_TYPE`	400	Tipo de archivo inválido. Solo se permiten archivos Excel (.xlsx, .xls).
`7630`	`FILE_IS_EMPTY`	400	El archivo no puede estar vacío

Configuración de proyecto e integridad de la app (`7700–7799`)

Código	Nombre	HTTP	Mensaje
`7700`	`PROJECT_CONFIG_NOT_FOUND`	404	Configuración del proyecto no encontrada
`7701`	`FORMS_NOT_FOUND`	500	Formularios del proyecto no encontrados
`7702`	`FORM_DETAIL_NOT_FOUND`	404	Detalles del formulario no encontrados
`7703`	`ERROR_UPDATING_PROJECT_CONFIG`	500	Error al actualizar la configuración del proyecto, contacta a soporte.
`7704`	`ERROR_CREATING_PROJECT_CONFIG`	500	Error al crear la configuración del proyecto, contacta a soporte.
`7705`	`MERCHANT_ALREADY_LINKED`	409	El comercio ya está vinculado, obtén un nuevo comercio o verifícalo.
`7706`	`APP_INTEGRITY_VALIDATION_FAILED`	403	Versión de la app no reconocida.
`7707`	`DEVICE_INTEGRITY_VALIDATION_FAILED`	403	Estado de integridad del dispositivo no reconocido.
`7708`	`LICENSING_INTEGRITY_VALIDATION_FAILED`	403	Estado de licenciamiento no reconocido.
`7709`	`INTEGRITY_TOKEN_EXPIRED_OR_INVALID`	401	El token de integridad ha expirado o es inválido.
`7710`	`INTEGRITY_INVALID_HASH`	400	El hash de integridad es inválido.
`7711`	`INTEGRITY_INVALID_APPLICATION_ID`	400	El ID de aplicación de integridad es inválido.
`7712`	`APP_CONFIG_INTEGRITY_NOT_FOUND`	404	Configuración de integridad de la app no encontrada.

App / Backoffice CMS (`8000–8099`)

Código	Nombre	HTTP	Mensaje
`8000`	`APP_ERROR_CREDENTIALS`	401	Credenciales inválidas, inténtalo de nuevo.
`8001`	`APP_NEED_CHANGE_PASSWORD`	401	Primero debes cambiar tu contraseña.
`8002`	`APP_INVALID_ACCESS_TOKEN`	401	Token de acceso inválido, inténtalo de nuevo.
`8003`	`APP_INVALID_REFRESH_TOKEN`	401	Refresh token inválido, inténtalo de nuevo.
`8004`	`APP_INVALID_OTP`	401	OTP inválido, inténtalo de nuevo.
`8005`	`APP_EMAIL_ALREADY_EXISTS`	409	El correo ya existe, intenta con otro correo.
`8006`	`APP_USER_NOT_FOUND`	404	Usuario no encontrado, verifica el id
`8007`	`APP_PARTNER_NOT_FOUND`	404	Partner no encontrado, verifica el id
`8008`	`APP_PERMISSIONS_NOT_FOUND`	404	Permisos asignados no encontrados, asigna permisos para este usuario.
`8009`	`APP_ERROR_USERS_FETCH`	500	Parámetros de consulta inválidos o ID de partner no encontrado
`8010`	`APP_STATUS_INVALID`	400	Estado de usuario inválido
`8011`	`APP_USER_SUSPENDED`	403	Usuario suspendido
`8012`	`APP_USER_NOT_CREATED`	400	Usuario no creado, inténtalo de nuevo.
`8013`	`APP_ERROR_CREATING_PERMISSIONS`	500	Permiso no creado, inténtalo de nuevo.
`8014`	`APP_ERROR_GETTING_PERMISSIONS`	500	Error al obtener los permisos, inténtalo de nuevo.
`8015`	`APP_ERROR_ASSIGN_PERMISSIONS`	500	Error al intentar asignar permisos al usuario.
`8016`	`APP_PERMISSIONS_ALREADY_ASSIGNED`	409	Uno o más permisos ya fueron asignados por este usuario para el partnerId
`8017`	`APP_ERROR_FINDING_ASSIGNED_PERMISSIONS`	500	Error al buscar los permisos asignados a este usuario
`8018`	`APP_USER_INACTIVE`	403	El usuario está inactivo
`8019`	`APP_USER_BLOCKED`	403	Usuario bloqueado
`8020`	`APP_INVALID_OTP_PURPOSE`	500	Propósito de OTP inválido.
`8021`	`APP_OTP_REQUIRED`	400	El OTP es obligatorio.
`8022`	`APP_TOKEN_INVALID`	401	El token es inválido.
`8023`	`APP_CARDHOLDER_NOT_FOUND`	404	Tarjetahabiente no encontrado, verifica la información
`8024`	`APP_TEMPORARY_PASSWORD_EXPIRED`	409	La contraseña temporal del usuario ha expirado; solicita una nueva a soporte.
`8025`	`APP_PROCESS_NOT_CREATED`	409	Proceso no creado
`8026`	`APP_PROCESS_NOT_FOUND`	404	Proceso no encontrado
`8027`	`APP_PROCESS_NOT_UPDATED`	409	Proceso no actualizado
`8028`	`APP_ERROR_PROCESS`	500	Error al procesar la solicitud
`8029`	`APP_CLIENT_BALANCE_NOT_FOUND`	404	Balance del cliente no encontrado
`8030`	`APP_CLIENT_BALANCE_ALREADY_EXISTS`	409	El balance del cliente ya existe
`8031`	`APP_CLIENT_BALANCE_NOT_UPDATED`	500	Balance del cliente no actualizado
`8032`	`APP_ERROR_CLIENT_BALANCE`	500	Error en el balance del cliente
`8033`	`APP_INSUFFICIENT_FUNDS_IN_CLIENT_ACCOUNT`	409	Fondos insuficientes en la cuenta del cliente
`8034`	`APP_PROCESS_NOT_PENDING`	500	El proceso no está pendiente
`8035`	`APP_PROCESS_NOT_APPROVED`	500	El proceso no está aprobado
`8036`	`APP_PROCESS_NOT_REJECTED`	500	El proceso no está rechazado

Notas

El identificador estable es el nombre del error (la clave MigoNameErrors, p. ej. CARD_NOT_FOUND). Cada nombre mapea a un code numérico fijo. Ramifica tu lógica de cliente con code, pero trata el nombre como la clave canónica del registro.
Los códigos son strings, no enteros — compáralos como strings ("7200", no 7200).
Se agregan códigos nuevos con el tiempo. Trata los códigos desconocidos como errores genéricos y reintenta solo cuando el status HTTP sea reintentable (p. ej. 503/504).
Algunos códigos no tienen mensaje registrado en MigoErrorMessages; para esos la API usa el fallback 7003 (CONSULT_WITH_SUPPORT, "Please contact support for assistance.").

ownCodes de Payment Link / Middleware

El Middleware (Payment Links, tokenización, pagos) devuelve errores en otro envelope (ErrorResponseDto) y expone el error de negocio en un campo llamado ownCode (anidado bajo error.ownCode) en vez de errors[].code. Los códigos son strings numéricos cortos (p. ej. "2002") y no se solapan con el rango 7000–8099 anterior.

Ciclo de vida de la transacción (`2000–2099`)

Estos provienen de la superficie de transacciones del Middleware — POST /mw-transactions (crear) y POST /mw-default/transactions-hook (hook de Payment Link). El tráfico público llega a estos a través del proxy mw.migopayments.com, que reescribe la ruta.

HTTP	`ownCode`	Causa	Qué hacer
400	`2002`	Error genérico de creación	Reintenta; si persiste, contacta a soporte con el payload de la solicitud y cualquier `uid` devuelto.
409	`2003`	`amount` está fuera de `clientConfig.createTransactionRangeAmount`, o un valor en `processorAmount` excede `amount`	Ajusta `amount` para que quede dentro del rango configurado; asegúrate de que cada valor de `processorAmount` sea `<= amount`.
400	`2004`	El cliente final (`userId`) está bloqueado para este client	Los usuarios bloqueados no pueden transaccionar — desbloquéalo a través de tu flujo de CMS antes de reintentar.
400	`2005`	El cliente final está suspendido para este client	Espera a que la suspensión expire o quítala a través del CMS.
400	`2006`	El cliente final está excluido para este client	Los usuarios excluidos no pueden transaccionar para este client en absoluto.
401	`2007`	Credenciales inválidas — el bearer token (para `/mw-transactions`) o `privateKey`/`publicKey` (para `/mw-default/transactions-hook`) no corresponde a una aplicación registrada	Verifica que estés usando credenciales de Sandbox contra URLs de Sandbox. Confirma que el token se envía sin el prefijo `Bearer` (ver Autenticación → Merchant token).

Validación / configuración (`5000–5099`)

Estos se devuelven cuando el body de la solicitud está mal formado o referencia algo que no existe en la configuración de Migo.

HTTP	`ownCode`	Causa	Qué hacer
409	`5000`	Campos requeridos faltantes o forma del body inválida	Verifica que `amount`, `userId`, `channel`, `client` (y `privateKey`/`publicKey` para `/mw-default/transactions-hook`) estén presentes con los tipos correctos.
409	`5004`	Slug de `client` no encontrado en la configuración de Migo	Confirma la escritura del slug. Si el client debería existir, pide a Migo crearlo o activarlo.

Leer el código de error de forma defensiva

type MiddlewareError = {
  message?: string;
  error?: {
    code?: number;     // status HTTP asociado al error
    ownCode?: string;  // código de error de negocio de Migo (string)
    message?: string;
  };
};

const code = err?.error?.ownCode;        // Middleware (anidado, string)
const fallback = err?.errors?.[0]?.code; // Gateway / CMS (string)

switch (String(code ?? fallback)) {
  case '2007': return 'Invalid Migo credentials';
  case '2003': return 'Amount out of allowed range';
  case '5004': return 'Unknown client slug';
  case '7200': return 'Card not found';
  // ...
}

Generales y parámetros (7000–7099)​

Usuarios, autenticación y OTP (7100–7199)​

Tarjetas (7200–7299)​

Transferencias y pagos (7300–7399)​

Terminales, negocios y sucursales (7400–7499)​

Liquidaciones y régimen (7500–7599)​

Clientes, roles, permisos y archivos (7600–7699)​

Configuración de proyecto e integridad de la app (7700–7799)​

App / Backoffice CMS (8000–8099)​

Notas​

ownCodes de Payment Link / Middleware​

Ciclo de vida de la transacción (2000–2099)​

Validación / configuración (5000–5099)​

Leer el código de error de forma defensiva​