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

