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

JSON

{
   "code": "<error_code>",
   "title": "<error_title>",
   "message": "<error_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.

Una respuesta 5xx puede llevar title con el texto del estado HTTP (por ejemplo Service Unavailable) y message con internal error. El code identifica el error, y las tablas de abajo dan su título del catálogo.

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.
PIX-0016	Servicio no disponible	Una dependencia del servicio no está disponible temporalmente. Inténtalo de nuevo más tarde.

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-0129	Tipo de cuenta no permitido	Las cuentas de nómina (SLRY) no se pueden usar para registrar ni reclamar una clave Pix, ni para recibir una clave movida desde otro tipo de cuenta.
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.
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.
PIX-3011	Conciliación no permitida	La conciliación completa solo se puede iniciar durante la ventana de bloqueo de escritura de entradas.

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-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.
PIX-0246	El monto devuelto no coincide	El effectiveRefundedAmount debe ser igual al monto solicitado cuando es TOTALLY_ACCEPTED, mayor que cero y menor que el monto solicitado cuando es PARTIALLY_ACCEPTED, y cero cuando es REJECTED.

Errores de MED (marcadores de fraude)

code	title	message
PIX-0260	Formato de documento no válido	El taxIdNumber debe ser un CPF (11 dígitos) o un CNPJ válido.
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 MED (recuperación de fondos)

code	title	message
PIX-0290	Recuperación de fondos no encontrada	La recuperación de fondos especificada no se encontró.
PIX-0291	La recuperación de fondos no se puede actualizar	La recuperación de fondos no se puede actualizar en su estado actual.
PIX-0292	La recuperación de fondos no se puede cancelar	La recuperación de fondos no se puede cancelar en su estado actual.
PIX-0293	La recuperación de fondos no puede solicitar devolución	La devolución solo se puede solicitar cuando el estado de la recuperación de fondos es ANALYSED.
PIX-0294	La recuperación de fondos ya existe	Ya existe una recuperación de fondos para esta transacción raíz.
PIX-0295	Parámetros del grafo de rastreo no válidos	Los parámetros del grafo de rastreo no son válidos.

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.
PIX-0331	Cobro de retiro ambiguo	El cobro especifica a la vez un objeto de retiro y uno de cambio, que la especificación de Pix trata como mutuamente excluyentes.
PIX-0332	Cobro de retiro no admitido	El cobro trae un bloque de retiro sin objeto de retiro ni de cambio, por lo que no se puede determinar su naturaleza.
PIX-0333	Cobro de retiro incompleto	Falta un campo obligatorio en el objeto de retiro: el monto del retiro, la modalidad del agente y el prestador de servicio de retiro son obligatorios.

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-0407	La cuenta de la transferencia no coincide	La transferencia no pertenece a la cuenta especificada.
PIX-0491	Informe de transacción no encontrado	No se encontró el informe de la transacción.

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-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-0429	Finalidad no admitida	La finalidad indicada no es admitida.
PIX-0481	Contested MED Root Transaction ID Required	El campo contestedMedRootTransactionId es obligatorio para INSTANT_PAYMENT_REFUND. Envía el rootTransactionId de la recuperación de fondos impugnada en el MED.
PIX-0482	Contested MED Root Transaction ID Invalid	El campo contestedMedRootTransactionId debe tener exactamente 32 caracteres (letras, dígitos o guion bajo).
PIX-0492	Valor de compra del retiro inconsistente	El cobro Pix Troco publica dos valores de compra que no coinciden, por lo que el total a pagar no se puede derivar del cobro.
PIX-0493	Valor de compra no permitido en el retiro	El cobro Pix Saque publica un valor de compra: ni el monto de la transacción del bloque de retiro ni el monto del propio cobro pueden ser positivos en un retiro puro.
PIX-0494	Agente de retiro no válido	El agente de retiro está incompleto: la modalidad del agente y el ISPB de 8 caracteres del prestador de servicio de retiro son obligatorios.
PIX-0495	Modalidad del agente de retiro no permitida	La modalidad del agente de retiro no está permitida para este tipo de transacción de retiro: un facilitador de servicio de retiro (AGPSS) no puede atender una operación Pix Troco.
PIX-0496	Finalidad no coincide con el cobro	La finalidad solicitada no coincide con el cobro que se paga: un cobro Pix Saque debe pagarse con WITHDRAWAL, un cobro Pix Troco con CHANGE, y un cobro sin datos de retiro con ninguna de las dos.
PIX-0497	Retiro no admitido en la liquidación intra-PSP	El agente de retiro de este cobro Pix Saque o Pix Troco está en la misma institución que el pagador, y la liquidación interna no puede llevar la identificación del retiro. El cobro no se puede pagar.
PIX-0498	Modalidad del agente de retiro desconocida	La modalidad del agente de retiro de este cobro no es una modalidad reconocida. La especificación de Pix define AGTEC, AGTOT y AGPSS.

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-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.
PIX-0447	Suma de operaciones no coincide	La suma de los montos de las operaciones no es igual al monto de la devolución.
PIX-0448	Alias de cuenta duplicado	Las operaciones contienen valores de accountAlias duplicados.
PIX-0449	Alias de cuenta ausente en la transacción original	Uno o más valores de accountAlias en las operaciones no participaron en la transacción original.
PIX-0490	Transacción original no encontrada	No se encontró la transacción original en el ledger.
PIX-0499	Devolución bloqueada: estado de la comisión desconocido	No se pudo determinar el estado de la comisión de la transacción original. La devolución queda bloqueada hasta una revisión manual.

Errores de idempotencia

Estos errores se aplican a las solicitudes que llevan un encabezado X-Idempotency: iniciación y procesamiento de cash-out Pix, creación de programación, creación de devolución y, en Pix Automático, la decisión del pagador, la confirmación de QR, el pagar y confirmar por QR y la cancelación de autorización.

code	title	message
PIX-3002	Conflicto	Una solicitud con esta clave de idempotencia sigue en proceso. Reintenta después del intervalo de Retry-After.
PIX-3004	Entidad no procesable	La clave de idempotencia ya se usó con un cuerpo de solicitud distinto.
PIX-3005	Entidad no procesable	El resultado de la solicitud original no se registró; concíliala y no la reenvíes.
PIX-3001	Solicitud incorrecta	La clave de idempotencia supera la longitud máxima de 256 caracteres.
PIX-3003	Solicitud incorrecta	La clave de idempotencia contiene caracteres no válidos. Solo se permiten letras, dígitos, guion, guion bajo y punto.
PIX-2011	Servicio no disponible	El almacén de idempotencia no está accesible, así que la solicitud no se procesó. Reintenta después del intervalo de Retry-After.

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 caracteres alfanuméricos en mayúsculas.
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 un CPF (11 dígitos) o un CNPJ válido.
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.
PIX-0460	El destino es la cuenta del pagador	El destino es la cuenta del propio pagador: un Pix no puede acreditar la cuenta que debita.

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-0480	PactualID no permitido	El PactualID no está permitido en transferencias entre cuentas del mismo PSP.

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 letras mayúsculas o 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-0512	Cuenta ambigua en CRM	Se encontró más de una cuenta en CRM para los criterios indicados. La asignación de la cuenta debe ser única.
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.
PIX-0603	Midaz no puede procesar la transacción	Midaz rechazó la transacción. La operación no se puede procesar en el estado actual.

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.
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.
PIX-0730	Location del cobro no encontrada	La location asociada a este cobro no se encontró.
PIX-0731	Location ya vinculada a un cobro activo	Otro cobro activo ya está vinculado a esta location.
PIX-0732	Cobro sin location vinculada	Este cobro no tiene una location vinculada para desvincular.
PIX-0733	Descuento mayor que el monto del cobro	El valor del descuento debe ser menor que el 100% del cobro y menor que el monto original del cobro.

Errores de programación

code	title	message
PIX-0800	Programación no encontrada	La programación no se encontró.
PIX-0801	Programación en el pasado	El momento de scheduledFor debe estar en el futuro (con tolerancia de 60 segundos de diferencia de reloj).
PIX-0802	Programación fuera de ventana	El momento de scheduledFor excede la ventana máxima permitida de 180 días en el futuro.
PIX-0804	Tipo de iniciación no válido	El tipo de iniciación debe ser MANUAL, KEY o QR_CODE.
PIX-0806	Recurrencia de la programación no válida	El recurrenceId no es un UUID válido.
PIX-0809	Programación en procesamiento	El worker está procesando la programación y no se puede cancelar.
PIX-0810	Monto de la programación no válido	El monto debe ser un decimal positivo.
PIX-0811	Datos de la programación no válidos	La solicitud de programación no tiene campos obligatorios o contiene valores no válidos.
PIX-0812	Clave de destino de la programación obligatoria	La clave de destino es obligatoria para los tipos de iniciación KEY y QR_CODE.
PIX-0814	Programación en estado final	La programación está en un estado final (ejecutada, fallida o cancelada) y no se puede cancelar.

Errores de recurrencia (pagador)

code	title	message
PIX-0900	Solicitud de autorización no encontrada	La solicitud de autorización no se encontró.
PIX-0901	Autorización no encontrada	La autorización no se encontró.
PIX-0902	Solicitud de autorización en estado no válido	La solicitud de autorización no está en un estado que permita esta operación.
PIX-0903	Solicitud de autorización expirada	La solicitud de autorización superó su plazo de validez.
PIX-0904	Carga de la recurrencia expirada	Los datos de la recurrencia leídos ya no están disponibles. Vuelve a leer el QR Code e inténtalo de nuevo.
PIX-0905	Monto máximo del receptor obligatorio	receiverMaxAmount es obligatorio cuando el monto de la solicitud de autorización es variable.
PIX-0906	Monto máximo del receptor no permitido	receiverMaxAmount no se debe enviar cuando el monto de la solicitud de autorización es fijo.
PIX-0907	Monto máximo del receptor fuera de rango	receiverMaxAmount está fuera del rango de montos declarado por el receptor.
PIX-0908	Falló la respuesta al receptor	Falló la entrega de la respuesta de la autorización a la institución receptora. No se creó ninguna autorización.
PIX-0909	Decisión no válida	La decisión debe ser ACCEPTED o REJECTED.
PIX-0910	Cobro no encontrado	El cobro no se encontró.
PIX-0911	Cobro en estado no válido	El cobro no está en un estado que permita esta operación.
PIX-0912	Intento de cobro no encontrado	El intento de cobro no se encontró.
PIX-0913	Estado de la autorización incompatible	Esta operación no se permite para el estado actual de la autorización.
PIX-0914	Motivo de cancelación obligatorio	El motivo de cancelación es obligatorio en las cancelaciones por fraude.
PIX-0915	Autor de la cancelación obligatorio	cancelledBy es obligatorio en las cancelaciones por fraude.
PIX-0916	Falló el pago de la recurrencia	El cobro inmediato de la autorización de Pix Automático no se pudo liquidar. La solicitud de autorización se marcó como pago fallido y no se creó ninguna autorización recurrente.

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-1011	Acceso denegado por el proveedor	El proveedor negó el acceso al recurso solicitado.
PIX-1012	Devolución no encontrada en el proveedor	El proveedor no tiene registro de esta devolución.
PIX-1018	Límite de claves excedido para la cuenta	Se superó el número máximo de claves para esta combinación de participante, agencia y cuenta.
PIX-1019	Clave restringida por sospecha de fraude	La clave está asociada a una cuenta o usuario restringido por sospecha fundamentada de fraude.
PIX-1020	Motivo de reclamación no válido	El motivo indicado para esta operación de reclamación no es válido.
PIX-1021	Tipo de clave incompatible con la reclamación	El tipo de clave es incompatible con el tipo de reclamación indicado.
PIX-1022	Reclamación no permitida para la titularidad de la clave	Esta reclamación no se puede crear con la titularidad actual de la clave (por ejemplo, una portabilidad de una clave que pertenece a otra persona, o una reclamación de propiedad de una clave que ya pertenece a quien reclama).
PIX-1023	La clave resultante de la reclamación ya existe	La clave que resultaría de completar esta reclamación ya existe.
PIX-1024	El estado de la reclamación no permite la operación	El estado actual de la reclamación no permite esta operación.
PIX-1025	El estado del reporte de infracción no permite la operación	El estado actual del reporte de infracción no permite esta operación.
PIX-1026	Ya existe un reporte de infracción cerrado	Ya existe un reporte de infracción cerrado para esta transacción.
PIX-1027	Motivo de recuperación de fondos no válido	El motivo indicado para esta operación de recuperación de fondos no es válido.
PIX-1028	Documento del iniciador de pago obligatorio	El documento del iniciador de pago es obligatorio cuando el tipo de iniciación es PAYMENT_INITIATOR.
PIX-1029	El identificador de la transacción debe referenciar un QR Code estático	El identificador de la transacción debe referenciar un identificador de QR Code estático cuando el tipo de iniciación es PAYMENT_INITIATOR.
PIX-1030	Clave del receptor obligatoria	La clave del receptor es obligatoria cuando el tipo de iniciación es DICT, QR Code estático o QR Code dinámico.
PIX-1031	Iniciador de pago no registrado	El CNPJ del iniciador de pago no está registrado en el arreglo Pix.
PIX-1032	Formato del identificador no válido para QR Code dinámico	El identificador de la transacción es obligatorio y debe tener entre 26 y 35 caracteres cuando el tipo de iniciación es QR Code dinámico.
PIX-1033	Formato del identificador no válido para QR Code estático	El identificador de la transacción debe tener como máximo 25 caracteres, cuando está presente, y el tipo de iniciación es QR Code estático.
PIX-1034	La urgencia debe ser normal en un pago programado	La urgencia debe ser NORMAL cuando el tipo de pago es SCHEDULED.
PIX-1035	Campos de monto del retiro inconsistentes	Los campos de monto de cambio y de compra del retiro son inconsistentes con el tipo de retiro de la transacción.
PIX-1036	Las partes del pago dividido deben ser personas jurídicas	El pagador y el receptor deben ser personas jurídicas para enviar un pago dividido.
PIX-1037	El pago dividido exige registros CBS e IBS	El pago dividido debe incluir exactamente dos registros: uno de tipo CBS y uno de tipo IBS.
PIX-1038	Monto del pago dividido mayor que el total	El monto del pago dividido no puede ser mayor que el monto total de la transacción.
PIX-1039	Datos del pago no encontrados	Los datos del pago solicitados no se encontraron.
PIX-1040	Cuenta no habilitada para pagos Pix	La cuenta registrada no está habilitada para transacciones de pago Pix.
PIX-1041	El estado del pago no permite la operación	El estado actual del pago no permite esta operación.
PIX-1042	Pago restringido o clave no encontrada	La cuenta o el usuario está restringido por sospecha de fraude, o no se encontró ninguna clave para los criterios de búsqueda.
PIX-1043	Transacción entre cuentas del mismo PSP no permitida	Las transacciones entre cuentas de la misma institución participante no están permitidas por este canal.
PIX-1044	Tipo de transacción no autorizado	Este tipo de transacción no está admitido ni autorizado en esta cuenta.
PIX-1045	Prestador de servicio de retiro no disponible	El prestador de servicio de retiro no puede procesar transacciones de pago Pix.
PIX-1046	El estado no permite la devolución	El pago no se puede devolver porque su estado no es CONFIRMED ni PARTIALLY_REVERTED.
PIX-1047	Monto de la devolución en cero	El monto de la devolución no puede ser cero.
PIX-1048	Saldo insuficiente para la devolución	El saldo disponible es insuficiente para cubrir el monto de la devolución.
PIX-1049	Monto de la devolución no coincide	El monto de la devolución recibido no coincide con el monto acordado o esperado.
PIX-1050	Fecha de corte de la devolución superada	La solicitud de devolución se recibió después de la fecha de corte de procesamiento acordada.
PIX-1051	Falló la liquidación de la devolución	Falló la liquidación de la transacción de devolución.
PIX-1052	Monto de la devolución superior al máximo	El monto de la devolución es mayor que el máximo permitido.
PIX-1053	Devolución denegada por motivo regulatorio	La devolución fue denegada por un motivo regulatorio.
PIX-1054	Plazo de devolución vencido	El plazo para devolver este pago Pix venció.
PIX-1055	Monto de la devolución mayor que la transacción original	El monto de la devolución es mayor que el monto de la transacción original.
PIX-1056	Bloqueado por PLD	La transacción fue bloqueada por la API de verificación de PLD (prevención de lavado de dinero).
PIX-1057	Naturaleza de la devolución no válida	La naturaleza de la devolución indicada no es válida.
PIX-1058	Cuenta en proceso de cierre	La operación fue denegada porque una de las cuentas involucradas está en proceso de cierre.
PIX-1059	Tiempo de espera de la devolución vencido	El tiempo de espera venció porque la orden quedó incompleta.
PIX-1060	Participante receptor dado de baja	El participante receptor fue dado de baja del SPI (sistema de pagos instantáneos).
PIX-1061	ClientRequestId duplicado	Ya existe una solicitud de devolución con este ClientRequestId.
PIX-1070	Location ya vinculada a otra recurrencia	La location ya está vinculada a otra recurrencia.
PIX-1071	Fecha inicial de la recurrencia no válida	La fecha inicial de la recurrencia no puede ser anterior a la fecha de creación de la recurrencia.
PIX-1072	Solo se permite la cancelación al pagador	Solo se permite la acción de cancelación al pagador.
PIX-1073	ISPB del pagador de la recurrencia no coincide	El ISPB del participante del pagador no coincide con el cliente que hace la solicitud.
PIX-1074	Pago confirmado de la recurrencia no encontrado	No se encontró ningún pago confirmado para el txId recibido.
PIX-1075	Acción del receptor en la recurrencia no válida	La acción solicitada por el receptor no es válida.
PIX-1076	PSP receptor no permitido en la recurrencia	El PSP receptor no tiene permiso para recibir solicitudes de confirmación de recurrencia.
PIX-1077	PSP pagador no permitido en la recurrencia	El PSP pagador no tiene permiso para responder solicitudes de autorización de recurrencia.
PIX-1078	txId de la recurrencia no coincide	El txId recibido en la confirmación difiere del txId creado con la recurrencia.
PIX-1079	Fecha de procesamiento de la recurrencia no coincide	La fecha de procesamiento de la actualización de la recurrencia no coincide con su estado.
PIX-1082	El solicitante de la cancelación no participa en la recurrencia	El documento del solicitante de la cancelación debe pertenecer a una de las partes involucradas: el PSP receptor, el usuario receptor, el PSP pagador o el usuario pagador.
PIX-1084	ID de la recurrencia no válido	El ID de la recurrencia no es válido.
PIX-1085	Solicitud de recurrencia duplicada	Ya existe una solicitud activa para el mismo ID de recurrencia.
PIX-1086	Recurrencia no encontrada o en aprobación	La recurrencia no existe o está actualmente en estado APPROVING.
PIX-1087	Flujo interno no permitido en la recurrencia	El flujo interno (intrabook) no está permitido para esta recurrencia.
PIX-1088	El proveedor exige el ID de la transacción raíz impugnada en el MED	El proveedor exige contestedMedRootTransactionId cuando el tipo de transacción es INSTANT_PAYMENT_REFUND.
PIX-1089	Documento del pagador de la devolución no coincide	Cuando el tipo de transacción es INSTANT_PAYMENT_REFUND, el proveedor exige que el documento del pagador sea el documento del PSP que envía la transacción.
PIX-1110	La clave Pix pertenece a otro titular	La clave Pix ya está registrada a nombre de otro titular. Inicia una reclamación de propiedad para obtener esta clave.
PIX-1111	Clave Pix ya 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-1121	Clave Pix bloqueada por una reclamación	La clave Pix está bloqueada por un proceso de reclamación. Espera a que el proceso termine.
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.