Saltar al contenido principal
El formato es el siguiente: 
{
   "code":"<error_code>",
   "title":"<error_title>",
   "message":"<error_message>"
}
Definición de campos
  • code: Un identificador único y estable para el error (formato: TRC-XXXX).
  • title: Un breve resumen del problema.
  • message: Orientación detallada para resolver el error.
Detalles de errores a nivel de campo Para problemas específicos de campos individuales, un objeto fields proporciona contexto adicional. Ejemplos: 
{
   "code":"TRC-0106",
   "title":"Missing Required Field",
   "message":"The name field is required. Please provide a name for the rule and try again.",
   "fields": {
      "name": "name is a required field"
   }
}

​
Errores generales

Estos errores se aplican a todos los endpoints de la API de Tracer.
CódigoTítuloMensajeTraducción
TRC-0001Validation ErrorField validation failed. Please verify the provided data and try again.La validación del campo falló. Por favor, verifique los datos proporcionados e intente de nuevo.
TRC-0002At Least One Field RequiredAt least one field must be provided for update. Please include at least one field and try again.Se debe proporcionar al menos un campo para la actualización. Por favor, incluya al menos un campo e intente de nuevo.
TRC-0003Invalid Request BodyThe request body is invalid or malformed. Please verify the JSON format and try again.El cuerpo de la solicitud es inválido o está mal formado. Por favor, verifique el formato JSON e intente de nuevo.
TRC-0004Internal Server ErrorAn unexpected error occurred. Please try again later or contact support if the issue persists.Ocurrió un error inesperado. Por favor, intente más tarde o contacte al soporte si el problema persiste.
TRC-0006Invalid Query ParametersOne or more query parameters are invalid. Please verify the parameters and try again.Uno o más parámetros de consulta son inválidos. Por favor, verifique los parámetros e intente de nuevo.
TRC-0007Invalid Path ParameterThe provided ID is not a valid UUID format. Please verify the ID and try again.El ID proporcionado no tiene un formato UUID válido. Por favor, verifique el ID e intente de nuevo.
TRC-0010API Key MissingA valid API Key must be provided in the X-API-Key header. Please include your API Key and try again.Se debe proporcionar una API Key válida en el encabezado X-API-Key. Por favor, incluya su API Key e intente de nuevo.
TRC-0011Invalid API KeyThe provided API Key is invalid or expired. Please provide a valid API Key and try again.La API Key proporcionada es inválida o ha expirado. Por favor, proporcione una API Key válida e intente de nuevo.
TRC-0012Payload Too LargeThe request payload exceeds the maximum size limit of 100KB. Please reduce the payload size and try again.El payload de la solicitud excede el límite máximo de 100KB. Por favor, reduzca el tamaño del payload e intente de nuevo.
TRC-0013Service UnavailableThe service is temporarily unavailable. Please try again later.El servicio no está disponible temporalmente. Por favor, intente más tarde.
TRC-0020Invalid Date FormatThe date must be in RFC3339 format with timezone (e.g., 2026-01-28T10:30:00Z). Date-only format is not accepted.La fecha debe estar en formato RFC3339 con zona horaria (ej., 2026-01-28T10:30:00Z). El formato solo de fecha no es aceptado.

​
Errores de paginación

CódigoTítuloMensajeTraducción
TRC-0040Limit Exceeds MaximumThe limit parameter exceeds the maximum allowed value. Please reduce the limit and try again.El parámetro limit excede el valor máximo permitido. Por favor, reduzca el límite e intente de nuevo.
TRC-0041Limit Below MinimumThe limit parameter must be at least 1. Please provide a valid limit and try again.El parámetro limit debe ser al menos 1. Por favor, proporcione un límite válido e intente de nuevo.
TRC-0042Invalid Sort OrderSort order must be ASC or DESC. Please provide a valid value.El orden de ordenación debe ser ASC o DESC. Por favor, proporcione un valor válido.
TRC-0043Invalid Sort ColumnThe specified sort column is not supported. Please check the allowed fields.La columna de ordenación especificada no es soportada. Por favor, verifique los campos permitidos.
TRC-0044Invalid Pagination CursorThe provided pagination cursor is invalid or expired. Please start a new query without a cursor.El cursor de paginación proporcionado es inválido o ha expirado. Por favor, inicie una nueva consulta sin cursor.
TRC-0045Sort Parameters LockedCannot change sortBy or sortOrder when using a pagination cursor. Please start a new query to change sort parameters.No se puede cambiar sortBy o sortOrder al usar un cursor de paginación. Por favor, inicie una nueva consulta para cambiar los parámetros de ordenación.

​
Errores de reglas

CódigoTítuloMensajeTraducción
TRC-0083Expression Syntax ErrorThe CEL expression contains a syntax error. Please verify the expression syntax and try again.La expresión CEL contiene un error de sintaxis. Por favor, verifique la sintaxis de la expresión e intente de nuevo.
TRC-0084Expression Type ErrorThe CEL expression must evaluate to a boolean value. Please modify the expression to return true or false.La expresión CEL debe evaluar a un valor booleano. Por favor, modifique la expresión para retornar true o false.
TRC-0085Expression Cost ExceededThe CEL expression computational cost exceeds the allowed limit. Please simplify the expression.El costo computacional de la expresión CEL excede el límite permitido. Por favor, simplifique la expresión.
TRC-0100Rule Not FoundThe requested rule does not exist. Please verify the rule ID and try again.La regla solicitada no existe. Por favor, verifique el ID de la regla e intente de nuevo.
TRC-0101Rule Name ConflictA rule with this name already exists. Please choose a different name and try again.Ya existe una regla con este nombre. Por favor, elija un nombre diferente e intente de nuevo.
TRC-0102Invalid Status TransitionThe requested status transition is not allowed. Please check the current rule status and valid transitions.La transición de estado solicitada no está permitida. Por favor, verifique el estado actual de la regla y las transiciones válidas.
TRC-0103Internal Server ErrorRule evaluation failed. Please try again or contact support.La evaluación de la regla falló. Por favor, intente de nuevo o contacte al soporte.
TRC-0104Expression Not ModifiableThe expression can only be modified when the rule is in DRAFT status. Please deactivate the rule first.La expresión solo puede ser modificada cuando la regla está en estado DRAFT. Por favor, desactive la regla primero.
TRC-0106Missing Required FieldThe name field is required. Please provide a name for the rule and try again.El campo name es requerido. Por favor, proporcione un nombre para la regla e intente de nuevo.
TRC-0107Name Too LongThe name exceeds the maximum length of 255 characters. Please reduce the name size.El nombre excede la longitud máxima de 255 caracteres. Por favor, reduzca el tamaño del nombre.
TRC-0108Missing Required FieldThe expression field is required. Please provide a CEL expression for the rule and try again.El campo expression es requerido. Por favor, proporcione una expresión CEL para la regla e intente de nuevo.
TRC-0109Expression Too LongThe expression exceeds the maximum length of 5000 characters. Please reduce the expression size.La expresión excede la longitud máxima de 5000 caracteres. Por favor, reduzca el tamaño de la expresión.
TRC-0110Invalid ActionThe action must be one of ALLOW, DENY, or REVIEW. Please provide a valid action.La acción debe ser una de ALLOW, DENY o REVIEW. Por favor, proporcione una acción válida.
TRC-0111Invalid ScopeEach scope must have at least one field set. Please provide at least one field in the scope.Cada scope debe tener al menos un campo definido. Por favor, proporcione al menos un campo en el scope.
TRC-0112Description Too LongThe description exceeds the maximum length of 1000 characters. Please reduce the description size.La descripción excede la longitud máxima de 1000 caracteres. Por favor, reduzca el tamaño de la descripción.
TRC-0113Scopes Exceed MaximumThe scopes exceed the maximum of 100 entries. Please reduce the number of scopes.Los scopes exceden el máximo de 100 entradas. Por favor, reduzca el número de scopes.

​
Errores de límites

CódigoTítuloMensajeTraducción
TRC-0120Limit Not FoundThe requested limit does not exist. Please verify the limit ID and try again.El límite solicitado no existe. Por favor, verifique el ID del límite e intente de nuevo.
TRC-0121Invalid Status TransitionThe requested status transition is not allowed. Please check the current limit status and valid transitions.La transición de estado solicitada no está permitida. Por favor, verifique el estado actual del límite y las transiciones válidas.
TRC-0122Invalid Limit TypeThe limitType must be one of DAILY, MONTHLY, or PER_TRANSACTION. Please provide a valid limit type.El limitType debe ser DAILY, MONTHLY o PER_TRANSACTION. Por favor, proporcione un tipo de límite válido.
TRC-0123Invalid AmountThe maxAmount must be a positive integer. Please provide a valid amount in cents.El maxAmount debe ser un entero positivo. Por favor, proporcione un monto válido en centavos.
TRC-0124Invalid Currency CodeThe currency must be a valid 3-letter ISO 4217 code (e.g., BRL, USD). Please provide a valid currency code.La moneda debe ser un código ISO 4217 de 3 letras válido (ej., BRL, USD). Por favor, proporcione un código de moneda válido.
TRC-0125Missing Required FieldAt least one scope is required for limits. Please provide at least one scope and try again.Se requiere al menos un scope para los límites. Por favor, proporcione al menos un scope e intente de nuevo.
TRC-0126Missing Required FieldThe name field is required. Please provide a name for the limit and try again.El campo name es requerido. Por favor, proporcione un nombre para el límite e intente de nuevo.
TRC-0127Name Too LongThe limit name exceeds the maximum allowed length. Please reduce the name size.El nombre del límite excede la longitud máxima permitida. Por favor, reduzca el tamaño del nombre.
TRC-0128Cannot Modify Deleted LimitThe limit has been deleted and cannot be modified. Please create a new limit if needed.El límite ha sido eliminado y no puede ser modificado. Por favor, cree un nuevo límite si es necesario.
TRC-0129Invalid NameThe name contains invalid characters. Please use only allowed characters.El nombre contiene caracteres inválidos. Por favor, use solo caracteres permitidos.
TRC-0130Invalid DescriptionThe description contains invalid characters. Please use only allowed characters.La descripción contiene caracteres inválidos. Por favor, use solo caracteres permitidos.
TRC-0131Immutable FieldThe limitType and currency fields cannot be modified after creation. Please create a new limit if you need different values.Los campos limitType y currency no pueden ser modificados después de la creación. Por favor, cree un nuevo límite si necesita valores diferentes.
TRC-0136Internal Server ErrorLimit check failed. Please try again or contact support.La verificación del límite falló. Por favor, intente de nuevo o contacte al soporte.

​
Errores de eventos de auditoría

CódigoTítuloMensajeTraducción
TRC-0140Audit Event Not FoundThe requested audit event does not exist. Please verify the event ID and try again.El evento de auditoría solicitado no existe. Por favor, verifique el ID del evento e intente de nuevo.
TRC-0141Invalid Audit Event FiltersOne or more audit event filters are invalid. Please verify the filter values and try again.Uno o más filtros de eventos de auditoría son inválidos. Por favor, verifique los valores de los filtros e intente de nuevo.

​
Errores de validación

CódigoTítuloMensajeTraducción
TRC-0060Metadata Key Too LongThe metadata key exceeds the maximum length of 64 characters. Please reduce the key size.La clave de metadata excede la longitud máxima de 64 caracteres. Por favor, reduzca el tamaño de la clave.
TRC-0063Metadata Exceeds Maximum EntriesThe metadata exceeds the maximum of 50 entries. Please reduce the number of entries.El metadata excede el máximo de 50 entradas. Por favor, reduzca el número de entradas.
TRC-0064Invalid Metadata KeyThe metadata key contains invalid characters. Only alphanumeric characters and underscore are allowed.La clave de metadata contiene caracteres inválidos. Solo se permiten caracteres alfanuméricos y guión bajo.
TRC-0220Missing Required FieldThe requestId field is required. Please provide a unique UUID for the request.El campo requestId es requerido. Por favor, proporcione un UUID único para la solicitud.
TRC-0221Invalid Transaction TypeThe transactionType must be one of CARD, WIRE, PIX, or CRYPTO. Please provide a valid transaction type.El transactionType debe ser CARD, WIRE, PIX o CRYPTO. Por favor, proporcione un tipo de transacción válido.
TRC-0222Invalid AmountThe amount must be a positive integer in cents. Please provide a valid amount.El amount debe ser un entero positivo en centavos. Por favor, proporcione un monto válido.
TRC-0223Missing Required FieldThe currency field is required. Please provide a valid ISO 4217 currency code.El campo currency es requerido. Por favor, proporcione un código de moneda ISO 4217 válido.
TRC-0224Invalid CurrencyThe currency must be a valid uppercase ISO 4217 code (e.g., BRL, USD). Lowercase codes are not accepted.La moneda debe ser un código ISO 4217 en mayúsculas válido (ej., BRL, USD). Los códigos en minúsculas no son aceptados.
TRC-0225Missing Required FieldThe transactionTimestamp field is required. Please provide a timestamp in RFC3339 format.El campo transactionTimestamp es requerido. Por favor, proporcione una fecha y hora en formato RFC3339.
TRC-0226Future Timestamp Not AllowedThe transactionTimestamp cannot be in the future. Please provide a valid timestamp.El transactionTimestamp no puede estar en el futuro. Por favor, proporcione un timestamp válido.
TRC-0227Missing Required FieldThe account field is required. Please provide account context for the validation.El campo account es requerido. Por favor, proporcione el contexto de la cuenta para la validación.
TRC-0229Gateway TimeoutThe validation processing exceeded the 80ms budget. Please try again or contact support if the issue persists.El procesamiento de validación excedió el presupuesto de 80ms. Por favor, intente de nuevo o contacte al soporte si el problema persiste.
TRC-0230Missing Required FieldThe segment.id field is required when the segment object is provided. Please provide the segment ID.El campo segment.id es requerido cuando el objeto segment es proporcionado. Por favor, proporcione el ID del segmento.
TRC-0231Missing Required FieldThe portfolio.id field is required when the portfolio object is provided. Please provide the portfolio ID.El campo portfolio.id es requerido cuando el objeto portfolio es proporcionado. Por favor, proporcione el ID del portfolio.
TRC-0232SubType Too LongThe subType field exceeds the maximum length of 50 characters. Please reduce the size.El campo subType excede la longitud máxima de 50 caracteres. Por favor, reduzca el tamaño.
TRC-0233Invalid Account TypeThe account.type must be one of checking, savings, or credit. Please provide a valid type.El account.type debe ser uno de checking, savings o credit. Por favor, proporcione un tipo válido.
TRC-0234Invalid Account StatusThe account.status must be one of active, suspended, or closed. Please provide a valid status.El account.status debe ser uno de active, suspended o closed. Por favor, proporcione un estado válido.
TRC-0235Invalid Merchant CategoryThe merchant.category must be a 4-digit MCC code. Please provide a valid category.El merchant.category debe ser un código MCC de 4 dígitos. Por favor, proporcione una categoría válida.
TRC-0236Invalid Merchant CountryThe merchant.country must be an ISO 3166-1 alpha-2 code (e.g., BR, US). Please provide a valid country code.El merchant.country debe ser un código ISO 3166-1 alpha-2 (ej., BR, US). Por favor, proporcione un código de país válido.
TRC-0237Missing Required FieldThe merchant.id field is required when the merchant object is provided. Please provide the merchant ID.El campo merchant.id es requerido cuando el objeto merchant es proporcionado. Por favor, proporcione el ID del comerciante.
TRC-0250Invalid FiltersOne or more transaction validation filters are invalid. Please verify the filter values and try again.Uno o más filtros de validación de transacción son inválidos. Por favor, verifique los valores de los filtros e intente de nuevo.
TRC-0251Transaction Validation Not FoundThe requested transaction validation does not exist. Please verify the validation ID and try again.La validación de transacción solicitada no existe. Por favor, verifique el ID de validación e intente de nuevo.
TRC-0252Gateway TimeoutThe query exceeded the allowed timeout. Please refine the filters to reduce the query scope.La consulta excedió el tiempo límite permitido. Por favor, refine los filtros para reducir el alcance de la consulta.