> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Lista de errores de Pix Indirecto > Pix Indirecto responde con errores estructurados, para que puedas identificar qué salió mal y cómo corregirlo. **Formato del error** ```jsonon JSON theme={null} { "code": "", "title": "", "message": "" } ``` **Definiciones de los campos** * **`code`** – Un identificador estable y único para el error. Resulta útil para el manejo programático y las solicitudes de soporte. * **`title`** – Un resumen breve y legible del problema. * **`message`** – Orientación detallada para ayudarte a resolver el error. ## Errores de Pix Indirecto *** Los siguientes errores pueden ocurrir al interactuar con los endpoints de Pix Indirecto. Cada error sigue nuestra estructura estándar. ### Error interno del servidor | `code` | `title` | `message` | | -------- | -------------------------- | ------------------------------------------------------------------------ | | PIX-0000 | Error interno del servidor | El servidor encontró un error inesperado. Vuelve a intentarlo más tarde. | ### Errores de middleware | `code` | `title` | `message` | | -------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PIX-0001 | Headers faltantes en la solicitud | A tu solicitud le faltan uno o más parámetros header obligatorios. Consulta la documentación para confirmar que tu solicitud incluya todos los parámetros header necesarios. | | PIX-0002 | Valor de header no válido | Uno o más valores de header no son válidos. Consulta la documentación para verificar el formato esperado y los valores permitidos de cada header. | | PIX-0003 | Campos faltantes en la solicitud | A tu solicitud le faltan uno o más campos obligatorios. Consulta la documentación para confirmar que tu solicitud incluya todos los campos necesarios. | | PIX-0004 | Valores de campo no válidos en la solicitud | Tu solicitud contiene uno o más campos con valores no válidos. Consulta la documentación para verificar que todos los campos tengan los valores correctos. | | PIX-0005 | Tipo de campo no válido en la solicitud | Tu solicitud contiene uno o más campos con un tipo de dato no válido. Consulta la documentación para verificar que todos los campos tengan el tipo correcto. | | PIX-0006 | Campos inesperados en la solicitud | El cuerpo de la solicitud contiene más campos de los esperados. Envía solo los campos permitidos según la documentación. | | PIX-0007 | Parámetros de ruta faltantes en la solicitud | A tu solicitud le faltan uno o más parámetros de ruta obligatorios. Consulta la documentación para confirmar que tu solicitud incluya todos los parámetros de ruta necesarios. | | PIX-0008 | Parámetro de ruta no válido en la solicitud | Uno o más parámetros de ruta no son válidos. Consulta la documentación para verificar el formato esperado y los valores permitidos de cada parámetro de ruta. | | PIX-0009 | Parámetros de consulta faltantes en la solicitud | A tu solicitud le faltan uno o más parámetros de consulta obligatorios. Consulta la documentación para confirmar que tu solicitud incluya todos los parámetros de consulta necesarios. | | PIX-0010 | Parámetro de consulta no válido en la solicitud | Uno o más parámetros de consulta no son válidos. Consulta la documentación para verificar el formato esperado y los valores permitidos de cada parámetro de consulta. | | PIX-0011 | Formato de marca de tiempo no válido | El formato de la marca de tiempo no es válido. Consulta la documentación para verificar el formato esperado. | | PIX-0012 | Metadatos no válidos | Los metadatos no son válidos. Consulta la documentación para verificar el formato esperado. | | PIX-0013 | Límite superado | La solicitud superó el límite permitido. | ### Errores de DICT | `code` | `title` | `message` | | -------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | PIX-0101 | No se puede proporcionar la clave EVP | Las claves EVP no se pueden proporcionar manualmente, se generan automáticamente. | | PIX-0102 | Formato de clave no válido | Formato no válido para el keyType especificado. | | PIX-0103 | La clave Pix ya existe | La clave Pix ya está registrada. | | PIX-0105 | CPF no coincide | El CPF no coincide con el documento del titular en CRM. | | PIX-0106 | CNPJ no coincide | El CNPJ no coincide con el documento del titular en CRM. | | PIX-0107 | Límite de claves Pix superado para el titular | Se superó el límite de claves para el titular. | | PIX-0108 | Límite de claves Pix superado para el tipo | Se superó el límite del tipo de clave. | | PIX-0109 | Fecha de apertura no válida | La fecha de apertura en CRM no es válida. Proporciona una fecha válida en el formato 'yyyy-mm-dd'. | | PIX-0110 | La clave Pix pertenece a otro titular | La clave Pix ya está registrada a nombre de otro titular. Inicia una reclamación de posesión para adquirir esta clave. | | PIX-0111 | La clave Pix ya está vinculada a otra cuenta | La clave Pix ya está vinculada a otra cuenta del mismo titular. Inicia una solicitud de portabilidad para transferir esta clave. | | PIX-0112 | Entrada no encontrada | La entrada no se encontró. | | PIX-0113 | Reclamación no encontrada | La reclamación no se encontró. | | PIX-0114 | Clave en cuenta bajo custodia | La entrada consultada está bajo custodia del participante que hace la consulta. | | PIX-0115 | No se puede actualizar la clave EVP | Las claves EVP no se pueden actualizar. | | PIX-0116 | Arreglo de claves vacío | El arreglo de claves no debe estar vacío. | | PIX-0117 | Arreglo de claves superó el límite | El arreglo de claves no debe superar los 200 elementos. | | PIX-0118 | Tipo de clave no permitido para la reclamación | Solo se permiten claves PHONE para las reclamaciones de posesión. | | PIX-0119 | La clave Pix ya está reclamada | Ya tienes una reclamación en curso para esta clave. | | PIX-0120 | La clave no existe | La clave Pix no existe en DICT. | | PIX-0121 | La clave Pix está bloqueada por una reclamación | La clave Pix está bloqueada actualmente por otro proceso de reclamación. | | PIX-0122 | No se puede reclamar la clave EVP | Las claves EVP no se pueden reclamar. | | PIX-0123 | La clave ya pertenece al titular | La clave Pix ya está vinculada al titular solicitante. | | PIX-0124 | No se puede reclamar la clave | No es posible reclamar esta clave. | | PIX-0165 | Entrada inactiva | La entrada no está en estado activo. | ### Errores de reclamación (confirmar) | `code` | `title` | `message` | | -------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | PIX-0125 | Estado de espera de resolución | La reclamación debe estar en estado WAITING\_RESOLUTION para ejecutar la acción. | | PIX-0126 | Debe ser el participante donante | La reclamación debe provenir del participante donante para confirmarse. | | PIX-0127 | No se puede confirmar la portabilidad | Las reclamaciones de portabilidad no se pueden confirmar con el motivo DEFAULT\_OPERATION. | | PIX-0128 | No se puede confirmar la posesión | Las reclamaciones de posesión no se pueden confirmar con el motivo DEFAULT\_OPERATION antes de que termine el período de resolución. | ### Errores de reclamación (cancelar) | `code` | `title` | `message` | | -------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | PIX-0134 | No se puede cancelar la reclamación | La reclamación no se puede cancelar en su estado actual. | | PIX-0135 | El donante no puede cancelar una reclamación abierta | El participante donante no puede cancelar una reclamación en estado OPEN. | | PIX-0136 | Motivo no válido para el reclamante | El reclamante no puede cancelar con el motivo proporcionado en este estado. | | PIX-0137 | Motivo no válido para el donante | El donante no puede cancelar con el motivo proporcionado en este estado. | | PIX-0141 | El donante no puede cancelar una portabilidad confirmada | El donante no puede cancelar una reclamación de portabilidad confirmada. | | PIX-0142 | El período de resolución no ha terminado | El período de resolución todavía no ha terminado para la cancelación por DEFAULT\_OPERATION. | | PIX-0143 | El período de cancelación de posesión no ha terminado | Las reclamaciones de posesión con DEFAULT\_OPERATION solo se pueden cancelar después de CompletionPeriodEnd + 16 días. | | PIX-0144 | El período de cancelación del donante expiró | El donante solo puede cancelar con FRAUD mientras no haya pasado CompletionPeriodEnd. | | PIX-0145 | Actor desconocido | El participante no es ni el reclamante ni el donante. | ### Errores de reclamación (completar) | `code` | `title` | `message` | | -------- | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | | PIX-0146 | Reclamación no confirmada | La reclamación debe estar en estado CONFIRMED. | | PIX-0147 | Debe ser el participante reclamante | Solo el participante reclamante puede completar una reclamación. | | PIX-0148 | El período de finalización de posesión no ha terminado | Las reclamaciones de posesión solo se pueden completar después de que termine el período de finalización. | | PIX-0149 | La reclamación no se puede reconocer | La reclamación no cumple las condiciones previas para el reconocimiento (debe estar en estado OPEN y quien llama debe ser el participante donante). | | PIX-0160 | La reclamación ya se completó | La reclamación ya se completó. | | PIX-0161 | La reclamación está cancelada | La reclamación se canceló y no se puede completar. | | PIX-0162 | No se puede completar la reclamación | La reclamación no se puede completar en su estado actual. | | PIX-0163 | El período de finalización no está definido | El período de finalización no está definido para esta reclamación. | | PIX-0164 | El período de finalización expiró | El período de finalización expiró para esta reclamación. | ### Errores de VSync / CID | `code` | `title` | `message` | | -------- | ------------------------- | ---------------------------------------------------------------------------- | | PIX-0150 | Archivo CID no encontrado | El archivo CID especificado no se encontró o no está listo para descargarse. | | PIX-0151 | Formato de CID no válido | El CID debe ser una cadena hexadecimal en minúsculas de 64 caracteres. | | PIX-0152 | CID no encontrado | El CID especificado no se encontró en DICT. | ### Errores de MED (informes de infracción) | `code` | `title` | `message` | | -------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | PIX-0200 | Informe de infracción no encontrado | El informe de infracción no se encontró. | | PIX-0201 | Detalles del informe demasiado largos | Los detalles del informe superan la longitud máxima permitida de 2000 caracteres. | | PIX-0202 | Formato de correo electrónico no válido | El formato del correo electrónico no es válido. | | PIX-0203 | Formato de teléfono no válido | El formato del teléfono no es válido. | | PIX-0204 | Informe de infracción duplicado | Ya existe un informe de infracción para esta transacción. | | PIX-0205 | Formato de ID de transacción no válido | El formato del ID de transacción debe coincidir con el formato de un E2E ID. | | PIX-0206 | No se puede cancelar el informe de infracción | El informe de infracción no se puede cancelar en su estado actual. | | PIX-0207 | No se puede cerrar el informe de infracción | El informe de infracción no se puede cerrar en su estado actual. | | PIX-0208 | Tipo de fraude obligatorio | El tipo de fraude es obligatorio cuando el resultado del análisis es AGREED. | | PIX-0209 | Detalles del análisis obligatorios | Los detalles del análisis son obligatorios cuando el tipo de fraude es OTHER. | | PIX-0210 | Detalles del análisis demasiado largos | Los detalles del análisis superan la longitud máxima permitida de 2000 caracteres. | | PIX-0211 | Transacción no encontrada | La transacción especificada no se encontró. | | PIX-0212 | Transacción demasiado antigua | La transacción ocurrió hace más de 80 días y no se puede reportar. | | PIX-0213 | No autorizado para abrir la solicitud de devolución | Un informe de infracción de solicitud de devolución solo puede abrirlo el PSP del pagador. | | PIX-0214 | No autorizado para abrir el informe de cancelación | Un informe de infracción de cancelación de devolución solo puede abrirlo el PSP del receptor. | | PIX-0215 | Tipo de transacción no válido | La transacción no es una transacción de devolución. Las infracciones de cancelación de devolución solo se pueden usar para transacciones de devolución (pacs.004). | | PIX-0216 | No autorizado para cerrar la solicitud de devolución | Un informe de infracción de solicitud de devolución debe cerrarlo el PSP del receptor. | | PIX-0217 | No autorizado para cerrar el informe de cancelación | Un informe de infracción de cancelación de devolución debe cerrarlo el PSP del pagador. | | PIX-0218 | Motivo de cancelación demasiado largo | El motivo de cancelación supera la longitud máxima permitida de 500 caracteres. | | PIX-0219 | Formato de ID no válido | El ID debe tener un formato UUID válido. | | PIX-0220 | Orden de rango de fechas no válido | La marca de tiempo modified\_before debe ser posterior a la marca de tiempo modified\_after. | | PIX-0221 | Transacción de devolución demasiado antigua | La transacción de devolución ocurrió hace más de 30 días y no se puede reportar para cancelación. | | PIX-0222 | Tipo de situación no válido | Los informes de infracción de cancelación de devolución deben usar situationType OTHER. | | PIX-0223 | No se puede reconocer el informe de infracción | El informe de infracción no se puede reconocer en su estado actual. | ### Errores de MED (solicitudes de devolución) | `code` | `title` | `message` | | -------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PIX-0230 | Formato de monto de devolución no válido | El monto de la devolución debe estar en formato decimal con exactamente 2 decimales (por ejemplo, 100.50). | | PIX-0231 | Detalles de la devolución demasiado largos | Los detalles de la devolución superan la longitud máxima permitida de 2000 caracteres. | | PIX-0232 | El monto de la devolución supera la transacción | El monto de la devolución no puede superar el monto de la transacción original. | | PIX-0233 | Faltan los detalles de la devolución | El campo refundDetails es obligatorio cuando refundReason es OPERATIONAL\_FLAW. | | PIX-0234 | Solicitud de devolución no encontrada | La solicitud de devolución especificada no se encontró. | | PIX-0235 | Falta el ID de la transacción de devolución | El ID de la transacción de devolución es obligatorio cuando la devolución se acepta (TOTALLY\_ACCEPTED o PARTIALLY\_ACCEPTED). | | PIX-0236 | Estado de la solicitud no válido | La solicitud no se puede cerrar porque ya está en estado CLOSED o CANCELLED. | | PIX-0237 | Falta el motivo de rechazo | El campo refundRejectionReason es obligatorio cuando analysisResult es REJECTED. | | PIX-0238 | Faltan los detalles del análisis | El campo analysisDetails es obligatorio cuando analysisResult es REJECTED y refundRejectionReason es INVALID\_REQUEST. | | PIX-0239 | No se puede cancelar la solicitud | La solicitud no se puede cancelar porque ya está en estado CLOSED o CANCELLED. | | PIX-0240 | Falta el informe de infracción | Una solicitud de devolución con motivo FRAUD requiere un informe de infracción previo que se haya cerrado con resultado AGREED. | | PIX-0241 | El informe de infracción expiró | El informe de infracción se cerró hace más de 72 horas. Las solicitudes de devolución deben crearse dentro de las 72 horas posteriores al cierre del informe de infracción. | | PIX-0242 | Solicitud de devolución duplicada | Ya existe una solicitud de devolución para esta transacción. | | PIX-0243 | La solicitud de devolución ya está cerrada | La solicitud de devolución ya está cerrada. | | PIX-0244 | La solicitud de devolución ya está cancelada | La solicitud de devolución ya está cancelada. | | PIX-0245 | El rango de fechas supera los 90 días | El rango de fechas entre modifiedAfter y modifiedBefore no puede superar los 90 días. | ### Errores de MED (marcadores de fraude) | `code` | `title` | `message` | | -------- | -------------------------------- | ------------------------------------------------------------------------------------ | | PIX-0260 | Formato de ID fiscal no válido | El taxIdNumber debe tener un formato válido de CPF (11 dígitos) o CNPJ (14 dígitos). | | PIX-0261 | Formato de clave no válido | La clave debe tener entre 8 y 32 caracteres. | | PIX-0262 | Marcador de fraude no encontrado | El marcador de fraude especificado no se encontró. | | PIX-0263 | No se puede cancelar el marcador | El marcador de fraude no se puede cancelar porque ya está en estado CANCELLED. | ### Errores de MED (estadísticas) | `code` | `title` | `message` | | -------- | ------------------------ | ------------------------------------------------------------------------------- | | PIX-0280 | Valor de clave no válido | El valor de la clave no es válido o supera la longitud máxima de 77 caracteres. | ### Errores de código QR | `code` | `title` | `message` | | -------- | ------------------------------------------ | ---------------------------------------------------------------------------- | | PIX-0300 | Formato EMV no válido | El payload EMV no sigue la especificación de formato EMV QCO válida. | | PIX-0301 | Código QR corrupto | Los datos del código QR están corruptos y no se pueden decodificar. | | PIX-0302 | Versión de código QR no compatible | La versión o el formato del código QR no son compatibles. | | PIX-0303 | Fecha de pago no válida | La fecha de pago supera el período de pago válido. | | PIX-0304 | Monto no válido | El monto debe ser mayor que cero y seguir el formato 0.00 con dos decimales. | | PIX-0305 | Ciudad no válida | La ciudad debe contener solo letras y espacios. | | PIX-0306 | Formato de TxID no válido | El formato del txId no es válido. | | PIX-0307 | Clave del receptor obligatoria | El campo receiverKey es obligatorio. | | PIX-0309 | Formato de código de categoría no válido | El categoryCode debe ser numérico. | | PIX-0310 | Nombre del comercio no válido | El nombre del comercio es obligatorio. | | PIX-0311 | Clave del receptor no encontrada | El receiverKey no se encontró. | | PIX-0312 | Clave del receptor no válida | El receiverKey no es válido. | | PIX-0314 | EMV obligatorio | El EMV es obligatorio. | | PIX-0315 | Payload EMV vacío | El payload EMV no puede estar vacío. | | PIX-0316 | EMV no encontrado | El código QR EMV no se encontró. | | PIX-0317 | Código de ciudad no válido | El código de ciudad no es válido. | | PIX-0318 | BR Code no encontrado | El BR Code solicitado no se encontró. | | PIX-0319 | Clave del receptor no asociada | La clave del receptor no está asociada con la cuenta. | | PIX-0320 | Nombre del comercio no válido | El nombre del comercio es obligatorio. | | PIX-0321 | Ciudad del comercio no válida | La ciudad del comercio debe contener solo letras y espacios. | | PIX-0322 | Código de categoría del comercio no válido | El código de categoría del comercio debe ser numérico. | | PIX-0324 | Valor de monto no válido | El monto no es un valor decimal válido. | | PIX-0327 | ID de solicitud del cliente no válido | El ID de solicitud del cliente debe ser un UUID válido. | | PIX-0328 | Tipo de imagen no válido | El tipo de imagen debe ser uno de los siguientes: Gif, Jpeg, Png. | | PIX-0329 | Píxeles por módulo no válidos | El valor de píxeles por módulo está fuera de los límites permitidos. | | PIX-0330 | Servicio no disponible | El servicio de decodificación no está disponible temporalmente. | ### Errores de transferencias | `code` | `title` | `message` | | -------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | PIX-0400 | Descripción demasiado larga | El campo de descripción supera la longitud máxima permitida de 140 caracteres. | | PIX-0401 | La descripción contiene HTML | La descripción contiene caracteres HTML no válidos. | | PIX-0402 | Formato de monto no válido | El monto debe tener el formato 0.00 con exactamente 2 decimales (de 1 a 10 dígitos antes del punto decimal). | | PIX-0403 | El monto debe ser positivo | El monto debe ser mayor que cero. | | PIX-0404 | Formato de UUID no válido | El formato del UUID no es válido. | | PIX-0405 | Formato de ID de extremo a extremo no válido | El formato del ID de extremo a extremo no es válido. | | PIX-0406 | Intra PSP no compatible | Las transferencias INTRA PSP (mismo participante) no son compatibles. El ISPB del banco de destino no puede ser el mismo que el del PSP de origen. | | PIX-0407 | La cuenta de la transferencia no coincide | La transferencia no pertenece a la cuenta especificada. | ### Errores de iniciación | `code` | `title` | `message` | | -------- | ------------------------------ | ------------------------------------------------------------ | | PIX-0410 | Iniciación no encontrada | La iniciación del pago no se encontró. | | PIX-0411 | Iniciación expirada | La iniciación del pago expiró. | | PIX-0412 | Iniciación ya usada | La iniciación del pago ya se procesó. | | PIX-0413 | Estado de iniciación no válido | La iniciación del pago está en un estado no válido. | | PIX-0414 | Destino obligatorio | El destino es obligatorio para el tipo de iniciación MANUAL. | | PIX-0415 | Tipo de iniciación no válido | El tipo de iniciación no es válido. | | PIX-0416 | Clave obligatoria | La clave es obligatoria para el tipo de iniciación KEY. | | PIX-0417 | EMV obligatorio | El EMV es obligatorio para el tipo de iniciación QR\_CODE. | | PIX-0418 | Destino no válido | El destino no es válido para el tipo de iniciación MANUAL. | ### Errores de cash-out | `code` | `title` | `message` | | -------- | --------------------------------- | ----------------------------------------------------------- | | PIX-0420 | Cash-out no encontrado | La transacción de cash-out no se encontró. | | PIX-0421 | Saldo insuficiente | El saldo es insuficiente para completar la transacción. | | PIX-0422 | El monto no coincide | El monto no coincide con el monto fijo del código QR. | | PIX-0423 | ID de extremo a extremo duplicado | Ya existe una transacción con este ID de extremo a extremo. | | PIX-0424 | Valor de monto no válido | El monto debe ser mayor que cero. | | PIX-0425 | Cash-in no encontrado | La transacción de cash-in no se encontró. | | PIX-0426 | Transferencia no encontrada | La transferencia no se encontró. | | PIX-0427 | Devolución no encontrada | La devolución no se encontró. | | PIX-0428 | Devolución duplicada | Ya existe una devolución para esta transacción. | ### Errores de cuenta | `code` | `title` | `message` | | -------- | -------------------- | -------------------------------------------------------- | | PIX-0430 | Cuenta no encontrada | La cuenta no se encontró en el ledger. | | PIX-0431 | Cuenta bloqueada | La cuenta está bloqueada y no puede hacer transacciones. | ### Errores de devolución | `code` | `title` | `message` | | -------- | ------------------------------------------ | -------------------------------------------------------------------------------------------- | | PIX-0440 | La transferencia original no es un cash-in | Solo las transferencias de cash-in se pueden reembolsar con devoluciones de cash-out. | | PIX-0441 | La transferencia original no está completa | Solo las transacciones completadas se pueden reembolsar. | | PIX-0442 | La devolución supera el original | El monto de la devolución supera el monto de la transacción original. | | PIX-0443 | Motivo de devolución no válido | El código del motivo de devolución no es válido. | | PIX-0444 | La devolución supera el monto neto | El monto de la devolución parcial supera el monto neto disponible después de las comisiones. | | PIX-0445 | Estado de transacción no válido | Solo las transacciones completadas se pueden reembolsar. | ### Errores de validación de destino | `code` | `title` | `message` | | -------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | PIX-0450 | Banco de destino obligatorio | El banco de destino es obligatorio. | | PIX-0451 | Banco de destino no válido | El banco de destino debe tener 8 dígitos. | | PIX-0452 | Sucursal de destino obligatoria | La sucursal de destino es obligatoria. | | PIX-0453 | Cuenta de destino obligatoria | La cuenta de destino es obligatoria. | | PIX-0454 | Tipo de cuenta de destino no válido | El tipo de cuenta de destino no es válido. | | PIX-0455 | Documento de destino obligatorio | El documento de destino es obligatorio. | | PIX-0456 | Documento de destino no válido | El documento de destino no es válido: debe ser CPF (11 dígitos) o CNPJ (14 dígitos). | | PIX-0457 | Nombre de destino obligatorio | El nombre de destino es obligatorio. | | PIX-0458 | Tipo de persona de destino no válido | El tipo de persona de destino no es válido. | | PIX-0459 | El tipo de persona de destino no coincide | El tipo de persona no coincide con el documento: CPF requiere NATURAL\_PERSON, CNPJ requiere LEGAL\_PERSON. | ### Errores de transición de estado | `code` | `title` | `message` | | -------- | ------------------------------------------- | -------------------------------------------------------- | | PIX-0470 | Transición de estado no válida | La transición de estado no es válida. | | PIX-0471 | La transferencia ya está en estado terminal | La transacción ya está en un estado terminal. | | PIX-0472 | No se puede cancelar | No se puede cancelar la transacción en su estado actual. | | PIX-0473 | Ya está en estado terminal | La operación ya está en un estado terminal. | ### Errores de integración (CRM) | `code` | `title` | `message` | | -------- | ---------------------------------- | ------------------------------------------------------------------------------------------ | | PIX-0500 | Error de conexión con CRM | No se pudo conectar con el servicio CRM. | | PIX-0501 | Error de autenticación con CRM | No se pudo autenticar con el servicio CRM. | | PIX-0502 | Cuenta no encontrada en CRM | La cuenta no se encontró en CRM para los criterios indicados. | | PIX-0503 | Titular no encontrado en CRM | El titular no se encontró en CRM. | | PIX-0504 | Sucursal no válida en CRM | La sucursal devuelta por CRM no es válida. Se esperan exactamente 4 dígitos. | | PIX-0505 | Número de cuenta no válido en CRM | El número de cuenta devuelto por CRM no es válido. Se esperan de 1 a 20 dígitos. | | PIX-0506 | Documento no válido en CRM | El documento (CPF/CNPJ) devuelto por CRM no es válido. | | PIX-0507 | Nombre no válido en CRM | El nombre devuelto por CRM no es válido o supera los 120 caracteres. | | PIX-0508 | Nombre comercial no válido en CRM | El nombre comercial devuelto por CRM no es válido o supera los 100 caracteres. | | PIX-0509 | Fecha de apertura no válida en CRM | La fecha de apertura devuelta por CRM no es válida. Formato esperado: yyyy-mm-dd. | | PIX-0510 | Tipo de cuenta no válido en CRM | El tipo de cuenta devuelto por CRM no es válido. Se espera: CACC, SLRY, SVGS, TRAN u OTHR. | | PIX-0599 | Solicitud incorrecta a CRM | CRM devolvió un error de solicitud incorrecta. | ### Errores de integración (Midaz) | `code` | `title` | `message` | | -------- | ----------------------------- | -------------------------------------------------------- | | PIX-0600 | Fondos insuficientes en Midaz | Fondos insuficientes en la cuenta de origen. | | PIX-0601 | Cuenta bloqueada en Midaz | La cuenta está bloqueada y no puede hacer transacciones. | | PIX-0602 | Error de conexión con Midaz | No se pudo conectar con Midaz. | ### Errores de integración (Fee Service) | `code` | `title` | `message` | | -------- | --------------------------------- | ------------------------------------ | | PIX-0650 | Error de conexión con Fee Service | No se pudo conectar con Fee Service. | ### Errores de cobranza | `code` | `title` | `message` | | -------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | PIX-0700 | Cobranza no encontrada | La cobranza no se encontró. | | PIX-0701 | TxID de cobranza duplicado | Ya existe una cobranza con este txId para el receptor. | | PIX-0702 | La cobranza ya está eliminada | La cobranza ya se eliminó. | | PIX-0703 | Tipo de cobranza no válido | El tipo de cobranza no es válido. | | PIX-0704 | Estado de cobranza no válido | El estado de la cobranza no es válido o no permite esta operación. | | PIX-0705 | Monto de cobranza no válido | El monto de la cobranza no es válido. | | PIX-0706 | Vencimiento de cobranza no válido / Clave del receptor no es propia | El vencimiento de la cobranza no es válido / La clave del receptor no está asociada con la cuenta. | | PIX-0707 | Fecha de vencimiento no válida / Deudor no válido | La fecha de vencimiento no es válida / La información del deudor no es válida. | | PIX-0708 | Vencimiento demasiado largo / La cobranza no tiene ID de proveedor | El vencimiento supera el máximo permitido: 30 días (2,592,000 segundos) / La cobranza no tiene pactual ID. | | PIX-0709 | TxID no válido / Motivo de eliminación no válido | El txID no es válido o no puede estar vacío / El motivo de eliminación debe ser DELETED\_BY\_USER o DELETED\_BY\_PSP. | | PIX-0710 | Documento del receptor no válido | El documento del receptor no es válido o no puede estar vacío. | | PIX-0711 | Nombre del receptor no válido | El nombre del receptor no es válido o no puede estar vacío. | | PIX-0712 | Dirección del receptor no válida | La dirección del receptor es obligatoria. | | PIX-0713 | Nombre del deudor no válido | El nombre del deudor no es válido o no puede estar vacío. | | PIX-0714 | Formato de CPF no válido | El formato del CPF no es válido: debe tener exactamente 11 dígitos. | | PIX-0715 | Formato de CNPJ no válido | El formato del CNPJ no es válido: debe tener exactamente 14 dígitos. | | PIX-0716 | ID de cuenta no válido | El ID de la cuenta no es válido o no puede estar vacío. | | PIX-0717 | Pactual ID no válido | El pactual ID no es válido o no puede estar vacío. | | PIX-0718 | ID de ubicación no válido | El ID de ubicación no es válido o no puede estar vacío. | | PIX-0719 | Multa no válida | La configuración de la multa está incompleta: se deben proporcionar el tipo y el valor. | | PIX-0720 | Interés no válido | La configuración del interés está incompleta: se deben proporcionar el tipo y el valor. | | PIX-0721 | Descuento no válido | La configuración del descuento está incompleta: se deben proporcionar el tipo, el valor y los días antes del vencimiento. | | PIX-0722 | Rebaja no válida | La configuración de la rebaja está incompleta: se deben proporcionar el tipo y el valor. | | PIX-0723 | Demasiada información adicional | La cantidad de elementos de información adicional supera el máximo permitido: 50. | | PIX-0724 | El monto de Pix Troco no coincide | El monto de la transacción de Pix Troco debe ser igual al monto original. | | PIX-0725 | Configuración de Pix Saque no válida | Pix Saque no puede tener monto de transacción, solo monto de retiro. | | PIX-0726 | No se permite actualizar la cobranza | No se permiten actualizaciones para esta cobranza. | | PIX-0727 | El documento del deudor no coincide | El documento del deudor del pago no coincide con el deudor de la cobranza. | | PIX-0728 | El tipo no coincide | El tipo de pago no coincide con el tipo de cobranza. | | PIX-0729 | El monto de la cobranza no coincide | El monto del pago no coincide con el monto de la cobranza. | ### Errores del proveedor (BTG) | `code` | `title` | `message` | | -------- | ----------------------------------------------------- | ----------------------------------------------------------------- | | PIX-1000 | Error de conexión con el proveedor | No se pudo conectar con el proveedor. | | PIX-1001 | Error de autenticación con el proveedor | No se pudo autenticar con el proveedor. | | PIX-1002 | Tiempo de espera agotado en la solicitud al proveedor | Se agotó el tiempo de espera de la solicitud al proveedor. | | PIX-1003 | Límite de frecuencia superado | Se superó el límite de frecuencia. Vuelve a intentarlo más tarde. | | PIX-1004 | Servicio del proveedor no disponible | El servicio del proveedor no está disponible temporalmente. | | PIX-1005 | Clave no encontrada | La clave Pix no se encontró. | | PIX-1006 | La clave ya existe | La clave Pix ya existe. | | PIX-1007 | Error interno del proveedor | El proveedor devolvió un error interno. | | PIX-1008 | Respuesta no válida del proveedor | El proveedor devolvió una respuesta no válida. | | PIX-1009 | Solicitud incorrecta al proveedor | El proveedor rechazó la solicitud por datos no válidos. | | PIX-1010 | El proveedor no puede procesar la solicitud | El proveedor no puede procesar la solicitud. | | PIX-1099 | Error no asignado del proveedor | El proveedor devolvió un error no asignado. | ### Errores del proveedor (MED) | `code` | `title` | `message` | | -------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------- | | PIX-1065 | Solicitud de devolución duplicada | El proveedor informa que ya existe una solicitud de devolución para esta transacción. | | PIX-1068 | Estado de solicitud no válido | El proveedor informa que la solicitud está en un estado no válido para esta operación. | | PIX-1069 | No se puede cancelar la solicitud | El proveedor informa que la solicitud no se puede cancelar debido a su estado actual. | | PIX-1080 | Marcador de fraude duplicado | El proveedor informa que ya existe un marcador de fraude para esta combinación de documento y clave. | | PIX-1081 | Tipo de fraude no válido | El proveedor informa que el tipo de fraude no es válido para esta operación. | | PIX-1083 | No se puede cancelar el marcador | El proveedor informa que el marcador no se puede cancelar debido a su estado actual. | | PIX-1090 | Estadísticas de persona no encontradas | El proveedor informa que no se encontraron estadísticas para el ID fiscal especificado. | | PIX-1091 | Estadísticas de clave no encontradas | El proveedor informa que no se encontraron estadísticas para la clave Pix especificada. |