Lista de errores de Indirect Pix BTG

Formato de error

{
   "code": "<error_code>",
   "title": "<error_title>",
   "message": "<error_message>"
}

Definiciones de campos

code – Un identificador único y estable para el error. Útil para el manejo programático y las solicitudes de soporte.
title – Un resumen breve y legible del problema.
message – Orientación detallada para ayudarle a resolver el error.

Esta estructura garantiza que siempre obtenga retroalimentación procesable cuando algo no sale como se esperaba.

Errores de Indirect Pix BTG

Los siguientes errores pueden ocurrir al interactuar con los endpoints de Indirect Pix BTG. Cada error sigue nuestra estructura estándar, facilitando la depuración y la respuesta a problemas de manera programática. Consulte las tablas a continuación para obtener una lista de posibles códigos de error, qué significan y cómo resolverlos.

400

Código	Título	Mensaje	Traducción
PIX-0001	Missing Headers in Request	Your request is missing one or more required header params. Please refer to the documentation to ensure all necessary header params are included in your request.	Su solicitud carece de uno o más parámetros de encabezado obligatorios. Consulte la documentación para asegurarse de que todos los parámetros de encabezado necesarios estén incluidos en su solicitud.
PIX-0002	Invalid Header Value	One or more header values are invalid. Please refer to the documentation to verify the expected format and allowed values for each header.	Uno o más valores de encabezado no son válidos. Consulte la documentación para verificar el formato esperado y los valores permitidos para cada encabezado.
PIX-0003	Missing Fields in Request	Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.	Su solicitud carece de uno o más campos obligatorios. Consulte la documentación para asegurarse de que todos los campos necesarios estén incluidos en su solicitud.
PIX-0004	Invalid Field Values in Request	Your request contains one or more fields with invalid values. Please refer to the documentation to verify that all fields have the correct values.	Su solicitud contiene uno o más campos con valores no válidos. Consulte la documentación para verificar que todos los campos tengan los valores correctos.
PIX-0005	Invalid Field Type in Request	Your request contains one or more fields with an invalid data type. Please refer to the documentation to verify that all fields have the correct type.	Su solicitud contiene uno o más campos con un tipo de dato no válido. Consulte la documentación para verificar que todos los campos tengan el tipo correcto.
PIX-0006	Unexpected Fields in Request	The request body contains more fields than expected. Please send only the allowed fields as per the documentation.	El cuerpo de la solicitud contiene más campos de los esperados. Envíe solo los campos permitidos según la documentación.
PIX-0007	Missing Path Parameters in Request	Your request is missing one or more required path parameters. Please refer to the documentation to ensure all necessary path parameters are included in your request.	Su solicitud carece de uno o más parámetros de ruta obligatorios. Consulte la documentación para asegurarse de que todos los parámetros de ruta necesarios estén incluidos en su solicitud.
PIX-0008	Invalid Path Parameter in Request	One or more path parameters are invalid. Please refer to the documentation to verify the expected format and allowed values for each path parameter.	Uno o más parámetros de ruta no son válidos. Consulte la documentación para verificar el formato esperado y los valores permitidos para cada parámetro de ruta.
PIX-0009	Missing Query Params in Request	Your request is missing one or more required query params. Please refer to the documentation to ensure all necessary query params are included in your request.	Su solicitud carece de uno o más parámetros de consulta obligatorios. Consulte la documentación para asegurarse de que todos los parámetros de consulta necesarios estén incluidos en su solicitud.
PIX-0010	Invalid Query Param in Request	One or more query params are invalid. Please refer to the documentation to verify the expected format and allowed values for each query param.	Uno o más parámetros de consulta no son válidos. Consulte la documentación para verificar el formato esperado y los valores permitidos para cada parámetro de consulta.
PIX-0011	Invalid Timestamp Format	The timestamp format is invalid. Please refer to the documentation to verify the expected format.	El formato de marca temporal no es válido. Consulte la documentación para verificar el formato esperado.
PIX-0012	Invalid Metadata	The metadata is invalid. Please refer to the documentation to verify the expected format.	Los metadatos no son válidos. Consulte la documentación para verificar el formato esperado.
PIX-0013	Limit Exceeded	The request exceeded the allowed limit.	La solicitud excedió el límite permitido.
PIX-0101	EVP Key Cannot Be Provided	EVP keys cannot be provided manually, they are automatically generated.	Las claves EVP no se pueden proporcionar manualmente, se generan automáticamente.
PIX-0102	Invalid Key Format	Invalid format for the specified keyType.	Formato no válido para el keyType especificado.
PIX-0105	CPF Mismatch	CPF does not match holder document in CRM.	El CPF no coincide con el documento del titular en CRM.
PIX-0106	CNPJ Mismatch	CNPJ does not match holder document in CRM.	El CNPJ no coincide con el documento del titular en CRM.
PIX-0107	Pix Key Limit Exceeded for Holder	The key limit has been exceeded for the holder.	Se ha excedido el límite de claves para el titular.
PIX-0108	Pix Key Limit Exceeded for Type	The key type limit has been exceeded.	Se ha excedido el límite del tipo de clave.
PIX-0109	Invalid Opening Date	The opening date in CRM is invalid. Please provide a valid date in the ‘yyyy-mm-dd’ format.	La fecha de apertura en CRM no es válida. Proporcione una fecha válida en el formato ‘yyyy-mm-dd’.
PIX-0116	Empty Keys Array	The keys array must not be empty.	El array de claves no debe estar vacío.
PIX-0117	Keys Array Exceeded Limit	The keys array must not exceed 200 items.	El array de claves no debe exceder los 200 elementos.
PIX-0118	Key Claim Type Not Allowed	Only PHONE keys are allowed for ownership claims.	Solo se permiten claves PHONE para reclamaciones de titularidad.
PIX-0120	Key Does Not Exist	The Pix key does not exist in DICT.	La clave Pix no existe en DICT.
PIX-0121	Pix Key Locked By Claim	The Pix key is currently locked by another claim process.	La clave Pix está actualmente bloqueada por otro proceso de reclamación.
PIX-0122	EVP Key Cannot Be Claimed	EVP keys cannot be claimed.	Las claves EVP no se pueden reclamar.
PIX-0124	Cannot Claim Key	It is not possible to claim this key.	No es posible reclamar esta clave.
PIX-0151	Invalid CID Format	The CID must be a 64-character lowercase hexadecimal string.	El CID debe ser una cadena hexadecimal en minúsculas de 64 caracteres.
PIX-0201	Report Details Too Long	The report details exceed the maximum allowed length of 2000 characters.	Los detalles del reporte exceden la longitud máxima permitida de 2000 caracteres.
PIX-0202	Invalid Email Format	The email format is invalid.	El formato del correo electrónico no es válido.
PIX-0203	Invalid Phone Format	The phone format is invalid.	El formato del teléfono no es válido.
PIX-0205	Invalid Transaction ID Format	The transaction ID format must match a E2E ID format.	El formato del ID de transacción debe coincidir con el formato de E2E ID.
PIX-0208	Infraction Fraud Type Required	The fraud type is required when analysis result is AGREED.	El tipo de fraude es obligatorio cuando el resultado del análisis es AGREED.
PIX-0209	Infraction Analysis Details Required	The analysis details are required when fraud type is OTHER.	Los detalles del análisis son obligatorios cuando el tipo de fraude es OTHER.
PIX-0210	Infraction Analysis Details Too Long	The analysis details exceed the maximum allowed length of 2000 characters.	Los detalles del análisis exceden la longitud máxima permitida de 2000 caracteres.
PIX-0212	Transaction Too Old	The transaction occurred more than 80 days ago and cannot be reported.	La transacción ocurrió hace más de 80 días y no se puede reportar.
PIX-0215	Invalid Transaction Type	The transaction is not a refund transaction. Cancellation of refund infractions can only be used for refund transactions (pacs.004).	La transacción no es una transacción de devolución. La cancelación de infracciones de devolución solo se puede usar para transacciones de devolución (pacs.004).
PIX-0218	Cancellation Reason Too Long	The cancellation reason exceeds the maximum allowed length of 500 characters.	El motivo de cancelación excede la longitud máxima permitida de 500 caracteres.
PIX-0219	Invalid ID Format	The ID must be a valid UUID format.	El ID debe tener un formato UUID válido.
PIX-0220	Invalid Date Range Order	The modified_before timestamp must be after modified_after timestamp.	La marca temporal modified_before debe ser posterior a la marca temporal modified_after.
PIX-0221	Refund Transaction Too Old	The refund transaction occurred more than 30 days ago and cannot be reported for cancellation.	La transacción de devolución ocurrió hace más de 30 días y no se puede reportar para cancelación.
PIX-0222	Invalid Situation Type	Refund cancellation infraction reports must use situationType OTHER.	Los reportes de infracción de cancelación de devolución deben usar situationType OTHER.
PIX-0230	Invalid Refund Amount Format	The refund amount must be in decimal format with exactly 2 decimal places (e.g., 100.50).	El monto de devolución debe estar en formato decimal con exactamente 2 decimales (ej., 100.50).
PIX-0231	Refund Details Too Long	The refund details exceed the maximum allowed length of 2000 characters.	Los detalles de devolución exceden la longitud máxima permitida de 2000 caracteres.
PIX-0232	Refund Amount Exceeds Transaction	The refund amount cannot exceed the original transaction amount.	El monto de devolución no puede exceder el monto de la transacción original.
PIX-0233	Missing Refund Details	The refundDetails field is required when refundReason is OPERATIONAL_FLAW.	El campo refundDetails es obligatorio cuando refundReason es OPERATIONAL_FLAW.
PIX-0235	Missing Refund Transaction ID	The refund transaction ID is required when the refund is accepted (TOTALLY_ACCEPTED or PARTIALLY_ACCEPTED).	El ID de transacción de devolución es obligatorio cuando la devolución es aceptada (TOTALLY_ACCEPTED o PARTIALLY_ACCEPTED).
PIX-0237	Missing Rejection Reason	The refundRejectionReason is required when analysisResult is REJECTED.	El campo refundRejectionReason es obligatorio cuando analysisResult es REJECTED.
PIX-0238	Missing Analysis Details	The analysisDetails field is required when analysisResult is REJECTED and refundRejectionReason is INVALID_REQUEST.	El campo analysisDetails es obligatorio cuando analysisResult es REJECTED y refundRejectionReason es INVALID_REQUEST.
PIX-0240	Missing Infraction Report	A refund request with reason FRAUD requires a prior infraction report that has been closed with AGREED result.	Una solicitud de devolución con motivo FRAUD requiere un reporte de infracción previo que haya sido cerrado con resultado AGREED.
PIX-0241	Infraction Report Expired	The infraction report was closed more than 72 hours ago. Refund requests must be created within 72 hours of infraction report closure.	El reporte de infracción fue cerrado hace más de 72 horas. Las solicitudes de devolución deben crearse dentro de las 72 horas posteriores al cierre del reporte de infracción.
PIX-0245	Date Range Exceeds 90 Days	The date range between modifiedAfter and modifiedBefore cannot exceed 90 days.	El rango de fechas entre modifiedAfter y modifiedBefore no puede exceder los 90 días.
PIX-0260	Invalid Tax ID Format	The taxIdNumber must be a valid CPF (11 digits) or CNPJ (14 digits) format.	El campo taxIdNumber debe tener un formato válido de CPF (11 dígitos) o CNPJ (14 dígitos).
PIX-0261	Invalid Key Format	The key must be between 8 and 32 characters.	La clave debe tener entre 8 y 32 caracteres.
PIX-0280	Invalid Key Value	The key value is invalid or exceeds the maximum length of 77 characters.	El valor de la clave no es válido o excede la longitud máxima de 77 caracteres.
PIX-0300	Invalid EMV Format	The EMV payload does not follow the valid EMV QCO format specification.	El payload EMV no sigue la especificación válida del formato EMV QCO.
PIX-0301	Corrupted QR Code	The QR Code data is corrupted and cannot be decoded.	Los datos del QR Code están corruptos y no se pueden decodificar.
PIX-0302	Unsupported QR Code Version	The QR Code version or format is not supported.	La versión o formato del QR Code no es compatible.
PIX-0303	Invalid Payment Date	The payment date exceeds the valid payment period.	La fecha de pago excede el período de pago válido.
PIX-0304	Invalid Amount	The amount must be greater than zero and follow the 0.00 format with two decimals.	El monto debe ser mayor que cero y seguir el formato 0.00 con dos decimales.
PIX-0305	Invalid City	The city must contain only letters and spaces.	La ciudad debe contener solo letras y espacios.
PIX-0306	Invalid TxID Format	The txId format is invalid.	El formato de txId no es válido.
PIX-0307	Receiver Key Required	The receiverKey is required.	El campo receiverKey es obligatorio.
PIX-0309	Invalid Category Code Format	The categoryCode must be numeric.	El campo categoryCode debe ser numérico.
PIX-0310	Invalid Merchant Name	The merchant name is required.	El nombre del comerciante es obligatorio.
PIX-0311	Receiver Key Not Found	The receiverKey was not found.	No se encontró el campo receiverKey.
PIX-0312	Invalid Receiver Key	The receiverKey is invalid.	El campo receiverKey no es válido.
PIX-0314	EMV Required	The EMV is required.	El EMV es obligatorio.
PIX-0315	Empty EMV Payload	The EMV payload cannot be empty.	El payload EMV no puede estar vacío.
PIX-0317	Invalid City Code	The city code is invalid.	El código de ciudad no es válido.
PIX-0319	Receiver Key Not Associated	The receiver key is not associated with the account.	La clave del receptor no está asociada con la cuenta.
PIX-0320	Invalid Merchant Name	The merchant name is required.	El nombre del comerciante es obligatorio.
PIX-0321	Invalid Merchant City	The merchant city must contain only letters and spaces.	La ciudad del comerciante debe contener solo letras y espacios.
PIX-0322	Invalid Merchant Category Code	The merchant category code must be numeric.	El código de categoría del comerciante debe ser numérico.
PIX-0324	Invalid Amount Value	The amount is not a valid decimal.	El monto no es un decimal válido.
PIX-0327	Invalid Client Request ID	The client request ID must be a valid UUID.	El ID de solicitud del cliente debe ser un UUID válido.
PIX-0328	Invalid Image Type	The image type must be one of: Gif, Jpeg, Png.	El tipo de imagen debe ser uno de: Gif, Jpeg, Png.
PIX-0329	Invalid Pixels Per Module	The pixels per module value is out of bounds.	El valor de píxeles por módulo está fuera de los límites.
PIX-0400	Description Too Long	The description field exceeds the maximum allowed length of 140 characters.	El campo de descripción excede la longitud máxima permitida de 140 caracteres.
PIX-0401	Description Contains HTML	The description contains invalid HTML characters.	La descripción contiene caracteres HTML no válidos.
PIX-0402	Invalid Amount Format	The amount must be in format 0.00 with exactly 2 decimal places (1-10 digits before decimal).	El monto debe estar en formato 0.00 con exactamente 2 decimales (1-10 dígitos antes del decimal).
PIX-0403	Amount Must Be Positive	The amount must be greater than zero.	El monto debe ser mayor que cero.
PIX-0404	Invalid UUID Format	The UUID format is invalid.	El formato de UUID no es válido.
PIX-0405	Invalid End-to-End ID Format	The end-to-end ID format is invalid.	El formato del ID de extremo a extremo no es válido.
PIX-0406	Intra PSP Not Supported	INTRA PSP transfers (same participant) are not supported. The destination bank ISPB cannot be the same as the source PSP.	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-0414	Destination Required	Destination is required for MANUAL initiation type.	El destino es obligatorio para el tipo de iniciación MANUAL.
PIX-0415	Invalid Initiation Type	The initiation type is invalid.	El tipo de iniciación no es válido.
PIX-0416	Key Required	Key is required for KEY initiation type.	La clave es obligatoria para el tipo de iniciación KEY.
PIX-0417	EMV Required	EMV is required for QR_CODE initiation type.	El EMV es obligatorio para el tipo de iniciación QR_CODE.
PIX-0418	Invalid Destination	The destination is invalid for MANUAL initiation type.	El destino no es válido para el tipo de iniciación MANUAL.
PIX-0422	Amount Mismatch	The amount does not match the fixed amount from QR code.	El monto no coincide con el monto fijo del QR Code.
PIX-0424	Invalid Amount Value	The amount must be greater than zero.	El monto debe ser mayor que cero.
PIX-0440	Original Transfer Not Cashin	Only cashin transfers can be refunded with cashout refunds.	Solo las transferencias de entrada se pueden devolver con devoluciones de salida.
PIX-0442	Refund Exceeds Original	The refund amount exceeds the original transaction amount.	El monto de devolución excede el monto de la transacción original.
PIX-0443	Invalid Refund Reason	The refund reason code is invalid.	El código de motivo de devolución no es válido.
PIX-0444	Refund Exceeds Net Amount	The partial refund amount exceeds net amount available after fees.	El monto de devolución parcial excede el monto neto disponible después de comisiones.
PIX-0450	Destination Bank Required	The destination bank is required.	El banco de destino es obligatorio.
PIX-0451	Destination Bank Invalid	The destination bank must be 8 digits.	El banco de destino debe tener 8 dígitos.
PIX-0452	Destination Branch Required	The destination branch is required.	La sucursal de destino es obligatoria.
PIX-0453	Destination Account Required	The destination account is required.	La cuenta de destino es obligatoria.
PIX-0454	Destination Account Type Invalid	The destination account type is invalid.	El tipo de cuenta de destino no es válido.
PIX-0455	Destination Document Required	The destination document is required.	El documento de destino es obligatorio.
PIX-0456	Destination Document Invalid	The destination document is invalid: must be CPF (11 digits) or CNPJ (14 digits).	El documento de destino no es válido: debe ser CPF (11 dígitos) o CNPJ (14 dígitos).
PIX-0457	Destination Name Required	The destination name is required.	El nombre de destino es obligatorio.
PIX-0458	Destination Person Type Invalid	The destination person type is invalid.	El tipo de persona de destino no es válido.
PIX-0459	Destination Person Type Mismatch	Person type does not match document: CPF requires NATURAL_PERSON, CNPJ requires LEGAL_PERSON.	El tipo de persona no coincide con el documento: CPF requiere NATURAL_PERSON, CNPJ requiere LEGAL_PERSON.
PIX-0700	Collection Not Found	The collection was not found.	El cobro no fue encontrado.
PIX-0701	Duplicate Collection TxID	A collection with this txId already exists for the receiver.	Ya existe un cobro con este txId para el receptor.
PIX-0703	Invalid Collection Type	The collection type is invalid.	El tipo de cobro no es válido.
PIX-0705	Invalid Collection Amount	The collection amount is invalid.	El monto del cobro no es válido.
PIX-0706	Invalid Collection Expiration / Receiver Key Not Owned	The collection expiration is invalid / The receiver key is not associated with the account.	La expiración del cobro no es válida / La clave del receptor no está asociada con la cuenta.
PIX-0707	Invalid Due Date / Invalid Debtor	The due date is invalid / The debtor information is invalid.	La fecha de vencimiento no es válida / La información del deudor no es válida.
PIX-0708	Expiration Too Long / Collection Has No Provider ID	The expiration exceeds the maximum allowed: 30 days (2,592,000 seconds) / The collection has no pactual ID.	La expiración excede el máximo permitido: 30 días (2,592,000 segundos) / El cobro no tiene ID de pactual.
PIX-0709	Invalid TxID / Invalid Delete Reason	The txID is invalid or cannot be empty / The delete reason must be DELETED_BY_USER or DELETED_BY_PSP.	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	Invalid Receiver Document	The receiver document is invalid or cannot be empty.	El documento del receptor no es válido o no puede estar vacío.
PIX-0711	Invalid Receiver Name	The receiver name is invalid or cannot be empty.	El nombre del receptor no es válido o no puede estar vacío.
PIX-0712	Invalid Receiver Address	The receiver address is required.	La dirección del receptor es obligatoria.
PIX-0713	Invalid Debtor Name	The debtor name is invalid or cannot be empty.	El nombre del deudor no es válido o no puede estar vacío.
PIX-0714	Invalid CPF Format	The CPF format is invalid: must be exactly 11 digits.	El formato del CPF no es válido: debe tener exactamente 11 dígitos.
PIX-0715	Invalid CNPJ Format	The CNPJ format is invalid: must be exactly 14 digits.	El formato del CNPJ no es válido: debe tener exactamente 14 dígitos.
PIX-0716	Invalid Account ID	The account ID is invalid or cannot be empty.	El ID de cuenta no es válido o no puede estar vacío.
PIX-0717	Invalid Pactual ID	The pactual ID is invalid or cannot be empty.	El ID de pactual no es válido o no puede estar vacío.
PIX-0718	Invalid Location ID	The location ID is invalid or cannot be empty.	El ID de ubicación no es válido o no puede estar vacío.
PIX-0719	Invalid Fine	The fine configuration is incomplete: both type and value must be provided.	La configuración de multa está incompleta: se deben proporcionar tanto el tipo como el valor.
PIX-0720	Invalid Interest	The interest configuration is incomplete: both type and value must be provided.	La configuración de interés está incompleta: se deben proporcionar tanto el tipo como el valor.
PIX-0721	Invalid Discount	The discount configuration is incomplete: type, value and days before due must be provided.	La configuración de descuento está incompleta: se deben proporcionar el tipo, el valor y los días antes del vencimiento.
PIX-0722	Invalid Abatement	The abatement configuration is incomplete: both type and value must be provided.	La configuración de reducción está incompleta: se deben proporcionar tanto el tipo como el valor.
PIX-0723	Too Many Additional Info	The number of additional info items exceeds the maximum allowed: 50.	El número de elementos de información adicional excede el máximo permitido: 50.
PIX-0724	PIX Troco Amount Mismatch	PIX Troco transaction amount must equal original amount.	El monto de la transacción PIX Troco debe ser igual al monto original.
PIX-0725	Invalid PIX Saque Configuration	PIX Saque cannot have transaction amount, only withdrawal amount.	PIX Saque no puede tener monto de transacción, solo monto de retiro.
PIX-0727	Debtor Document Mismatch	The payment debtor document does not match the collection debtor.	El documento del deudor del pago no coincide con el deudor del cobro.
PIX-0728	Type Mismatch	The payment type does not match the collection type.	El tipo de pago no coincide con el tipo de cobro.
PIX-0729	Collection Amount Mismatch	The payment amount does not match the collection amount.	El monto del pago no coincide con el monto del cobro.
PIX-1009	Provider Bad Request	Provider rejected the request due to invalid data.	El proveedor rechazó la solicitud debido a datos no válidos.
PIX-1081	Invalid Fraud Type	The provider reports that the fraud type is not valid for this operation.	El proveedor informa que el tipo de fraude no es válido para esta operación.

403

Código	Título	Mensaje	Traducción
PIX-0115	EVP Key Cannot Be Updated	EVP keys cannot be updated.	Las claves EVP no se pueden actualizar.
PIX-0126	Must Be Donor Participant	The claim must be from the donor participant to confirm.	La reclamación debe ser del participante donante para confirmar.
PIX-0135	Donor Cannot Cancel Open Claim	The donor participant cannot cancel a claim in OPEN status.	El participante donante no puede cancelar una reclamación en estado OPEN.
PIX-0141	Donor Cannot Cancel Confirmed Portability	The donor cannot cancel a confirmed portability claim.	El donante no puede cancelar una reclamación de portabilidad confirmada.
PIX-0145	Unknown Actor	The participant is neither the claimer nor the donor.	El participante no es ni el reclamante ni el donante.
PIX-0147	Must Be Claimer Participant	Only the claimer participant can complete a claim.	Solo el participante reclamante puede completar una reclamación.
PIX-0213	Unauthorized to Open Refund Request	A refund request infraction report can only be opened by the payer’s PSP.	Un reporte de infracción de solicitud de devolución solo puede ser abierto por el PSP del pagador.
PIX-0214	Unauthorized to Open Cancellation Report	A cancellation of refund infraction report can only be opened by the payee’s PSP.	Un reporte de infracción de cancelación de devolución solo puede ser abierto por el PSP del beneficiario.
PIX-0216	Unauthorized to Close Refund Request	A refund request infraction report must be closed by the payee’s PSP.	Un reporte de infracción de solicitud de devolución debe ser cerrado por el PSP del beneficiario.
PIX-0217	Unauthorized to Close Cancellation Report	A cancellation of refund infraction report must be closed by the payer’s PSP.	Un reporte de infracción de cancelación de devolución debe ser cerrado por el PSP del pagador.
PIX-0431	Account Blocked	The account is blocked and cannot perform transactions.	La cuenta está bloqueada y no puede realizar transacciones.
PIX-0501	CRM Authentication Error	Failed to authenticate with CRM service.	Error al autenticarse con el servicio CRM.
PIX-0601	Midaz Account Blocked	The account is blocked and cannot perform transactions.	La cuenta está bloqueada y no puede realizar transacciones.
PIX-0726	Collection Update Not Allowed	Updates are not allowed for this collection.	No se permiten actualizaciones para este cobro.
PIX-1001	Provider Authentication Error	Failed to authenticate with provider.	Error al autenticarse con el proveedor.

404

Código	Título	Mensaje	Traducción
PIX-0112	Entry Not Found	The entry was not found.	La entrada no fue encontrada.
PIX-0113	Claim Not Found	The claim was not found.	La reclamación no fue encontrada.
PIX-0150	CID File Not Found	The specified CID file was not found or is not ready for download.	El archivo CID especificado no fue encontrado o no está listo para descargar.
PIX-0152	CID Not Found	The specified CID was not found in DICT.	El CID especificado no fue encontrado en DICT.
PIX-0200	Infraction Report Not Found	The infraction report was not found.	El reporte de infracción no fue encontrado.
PIX-0211	Transaction Not Found	The specified transaction was not found.	La transacción especificada no fue encontrada.
PIX-0234	Refund Request Not Found	The specified refund request was not found.	La solicitud de devolución especificada no fue encontrada.
PIX-0262	Fraud Marker Not Found	The specified fraud marker was not found.	El marcador de fraude especificado no fue encontrado.
PIX-0316	EMV Not Found	The EMV QR Code was not found.	El EMV QR Code no fue encontrado.
PIX-0318	BR Code Not Found	The requested BR Code was not found.	El BR Code solicitado no fue encontrado.
PIX-0407	Transfer Account Mismatch	The transfer does not belong to the specified account.	La transferencia no pertenece a la cuenta especificada.
PIX-0410	Initiation Not Found	The payment initiation was not found.	La iniciación de pago no fue encontrada.
PIX-0420	Cashout Not Found	The cashout transaction was not found.	La transacción de salida no fue encontrada.
PIX-0425	Cashin Not Found	The cashin transaction was not found.	La transacción de entrada no fue encontrada.
PIX-0426	Transfer Not Found	The transfer was not found.	La transferencia no fue encontrada.
PIX-0427	Refund Not Found	The refund was not found.	La devolución no fue encontrada.
PIX-0430	Account Not Found	The account was not found in ledger.	La cuenta no fue encontrada en el libro mayor.
PIX-0502	Account Not Found in CRM	The account was not found in CRM for the given criteria.	La cuenta no fue encontrada en CRM para los criterios proporcionados.
PIX-0503	Holder Not Found in CRM	The holder was not found in CRM.	El titular no fue encontrado en CRM.
PIX-1005	Key Not Found	The Pix key was not found.	La clave Pix no fue encontrada.
PIX-1090	Person Statistics Not Found	The provider reports that no statistics were found for the specified tax ID.	El proveedor informa que no se encontraron estadísticas para el ID fiscal especificado.
PIX-1091	Key Statistics Not Found	The provider reports that no statistics were found for the specified Pix key.	El proveedor informa que no se encontraron estadísticas para la clave Pix especificada.

409

Código	Título	Mensaje	Traducción
PIX-0103	Pix Key Already Exists	The Pix key is already registered.	La clave Pix ya está registrada.
PIX-0110	Pix Key Belongs to Another Holder	The Pix key is already registered to another holder. Please initiate an ownership claim to acquire this key.	La clave Pix ya está registrada a nombre de otro titular. Inicie una reclamación de titularidad para adquirir esta clave.
PIX-0111	Pix Key Already Linked to Another Account	The Pix key is already linked to another account of the same holder. Please initiate a portability request to transfer this key.	La clave Pix ya está vinculada a otra cuenta del mismo titular. Inicie una solicitud de portabilidad para transferir esta clave.
PIX-0119	Pix Key Already Claimed	You already have a claim in progress for this key.	Ya tiene una reclamación en curso para esta clave.
PIX-0123	Key Already Belongs to Holder	The Pix key is already linked to the requesting holder.	La clave Pix ya está vinculada al titular solicitante.
PIX-0160	Claim Already Completed	The claim has already been completed.	La reclamación ya ha sido completada.
PIX-0161	Claim Is Cancelled	The claim has been cancelled and cannot be completed.	La reclamación ha sido cancelada y no se puede completar.
PIX-0204	Duplicate Infraction Report	An infraction report already exists for this transaction.	Ya existe un reporte de infracción para esta transacción.
PIX-0242	Duplicate Refund Request	A refund request already exists for this transaction.	Ya existe una solicitud de devolución para esta transacción.
PIX-0412	Initiation Already Used	The payment initiation has already been processed.	La iniciación de pago ya ha sido procesada.
PIX-0423	Duplicate End-to-End ID	A transaction with this end-to-end ID already exists.	Ya existe una transacción con este ID de extremo a extremo.
PIX-0428	Duplicate Refund	A refund already exists for this transaction.	Ya existe una devolución para esta transacción.
PIX-0702	Collection Already Deleted	The collection has already been deleted.	El cobro ya ha sido eliminado.
PIX-1006	Key Already Exists	The Pix key already exists.	La clave Pix ya existe.
PIX-1065	Duplicate Refund Request	The provider reports that a refund request already exists for this transaction.	El proveedor informa que ya existe una solicitud de devolución para esta transacción.
PIX-1080	Duplicate Fraud Marker	The provider reports that a fraud marker already exists for this document and key combination.	El proveedor informa que ya existe un marcador de fraude para esta combinación de documento y clave.

422

Código	Título	Mensaje	Traducción
PIX-0114	Key In Custody Account	The entry queried is in custody of the participant making the query.	La entrada consultada está en custodia del participante que realiza la consulta.
PIX-0125	Waiting Resolution Status	The claim must be in WAITING_RESOLUTION status to execute the action.	La reclamación debe estar en estado WAITING_RESOLUTION para ejecutar la acción.
PIX-0127	Portability Cannot Be Confirmed	Portability claims cannot be confirmed with DEFAULT_OPERATION reason.	Las reclamaciones de portabilidad no se pueden confirmar con motivo DEFAULT_OPERATION.
PIX-0128	Ownership Cannot Be Confirmed	Ownership claims cannot be confirmed with DEFAULT_OPERATION reason before the resolution period has ended.	Las reclamaciones de titularidad no se pueden confirmar con motivo DEFAULT_OPERATION antes de que haya finalizado el período de resolución.
PIX-0134	Claim Cannot Be Cancelled	The claim cannot be cancelled in current status.	La reclamación no se puede cancelar en el estado actual.
PIX-0136	Invalid Reason for Claimer	The claimer cannot cancel with the provided reason in this status.	El reclamante no puede cancelar con el motivo proporcionado en este estado.
PIX-0137	Invalid Reason for Donor	The donor cannot cancel with the provided reason in this status.	El donante no puede cancelar con el motivo proporcionado en este estado.
PIX-0142	Resolution Period Not Ended	The resolution period has not ended yet for DEFAULT_OPERATION cancellation.	El período de resolución aún no ha finalizado para la cancelación por DEFAULT_OPERATION.
PIX-0143	Ownership Cancel Period Not Ended	Ownership claims with DEFAULT_OPERATION can only be cancelled after CompletionPeriodEnd + 16 days.	Las reclamaciones de titularidad con DEFAULT_OPERATION solo se pueden cancelar después de CompletionPeriodEnd + 16 días.
PIX-0144	Donor Cancel Period Expired	The donor can only cancel with FRAUD while CompletionPeriodEnd has not passed.	El donante solo puede cancelar con FRAUD mientras CompletionPeriodEnd no haya pasado.
PIX-0146	Claim Not Confirmed	The claim must be in CONFIRMED status.	La reclamación debe estar en estado CONFIRMED.
PIX-0148	Ownership Completion Period Not Ended	Ownership claims can only be completed after the completion period has ended.	Las reclamaciones de titularidad solo se pueden completar después de que haya finalizado el período de finalización.
PIX-0149	Claim Not Acknowledgeable	The claim does not meet acknowledgement preconditions (must be OPEN status and caller must be the donor participant).	La reclamación no cumple las precondiciones de reconocimiento (debe estar en estado OPEN y el llamante debe ser el participante donante).
PIX-0162	Claim Cannot Be Completed	The claim cannot be completed in its current status.	La reclamación no se puede completar en su estado actual.
PIX-0163	Completion Period Not Set	The completion period is not set for this claim.	El período de finalización no está establecido para esta reclamación.
PIX-0164	Completion Period Expired	The completion period has expired for this claim.	El período de finalización ha expirado para esta reclamación.
PIX-0165	Entry Inactive	The entry is not in active status.	La entrada no está en estado activo.
PIX-0206	Infraction Report Cannot Be Cancelled	The infraction report cannot be cancelled in current status.	El reporte de infracción no se puede cancelar en el estado actual.
PIX-0207	Infraction Report Cannot Be Closed	The infraction report cannot be closed in current status.	El reporte de infracción no se puede cerrar en el estado actual.
PIX-0223	Infraction Report Cannot Be Acknowledged	The infraction report cannot be acknowledged in current status.	El reporte de infracción no se puede reconocer en el estado actual.
PIX-0236	Invalid Request Status	The request cannot be closed because it is already in CLOSED or CANCELLED status.	La solicitud no se puede cerrar porque ya está en estado CLOSED o CANCELLED.
PIX-0239	Cannot Cancel Request	The request cannot be cancelled because it is already in CLOSED or CANCELLED status.	La solicitud no se puede cancelar porque ya está en estado CLOSED o CANCELLED.
PIX-0243	Refund Request Already Closed	The refund request is already closed.	La solicitud de devolución ya está cerrada.
PIX-0244	Refund Request Already Cancelled	The refund request is already cancelled.	La solicitud de devolución ya está cancelada.
PIX-0263	Cannot Cancel Marker	The fraud marker cannot be cancelled because it is already in CANCELLED status.	El marcador de fraude no se puede cancelar porque ya está en estado CANCELLED.
PIX-0411	Initiation Expired	The payment initiation has expired.	La iniciación de pago ha expirado.
PIX-0413	Initiation Invalid State	The payment initiation is in an invalid state.	La iniciación de pago está en un estado no válido.
PIX-0421	Insufficient Balance	Insufficient balance to complete the transaction.	Saldo insuficiente para completar la transacción.
PIX-0441	Original Transfer Not Complete	Only completed transactions can be refunded.	Solo las transacciones completadas se pueden devolver.
PIX-0445	Invalid Transaction Status	Only completed transactions can be refunded.	Solo las transacciones completadas se pueden devolver.
PIX-0470	Invalid Status Transition	The status transition is invalid.	La transición de estado no es válida.
PIX-0471	Transfer Already Terminal	The transaction is already in a terminal state.	La transacción ya está en un estado terminal.
PIX-0472	Cannot Cancel	Cannot cancel transaction in current status.	No se puede cancelar la transacción en el estado actual.
PIX-0473	Already Terminal	The operation is already in a terminal state.	La operación ya está en un estado terminal.
PIX-0504	Invalid Branch in CRM	The branch returned by CRM is invalid. Expected exactly 4 digits.	La sucursal devuelta por CRM no es válida. Se esperan exactamente 4 dígitos.
PIX-0505	Invalid Account Number in CRM	The account number returned by CRM is invalid. Expected 1-20 digits.	El número de cuenta devuelto por CRM no es válido. Se esperan de 1 a 20 dígitos.
PIX-0506	Invalid Document in CRM	The document (CPF/CNPJ) returned by CRM is invalid.	El documento (CPF/CNPJ) devuelto por CRM no es válido.
PIX-0507	Invalid Name in CRM	The name returned by CRM is invalid or exceeds 120 characters.	El nombre devuelto por CRM no es válido o excede los 120 caracteres.
PIX-0508	Invalid Trade Name in CRM	The trade name returned by CRM is invalid or exceeds 100 characters.	El nombre comercial devuelto por CRM no es válido o excede los 100 caracteres.
PIX-0509	Invalid Opening Date in CRM	The opening date returned by CRM is invalid. Expected format: yyyy-mm-dd.	La fecha de apertura devuelta por CRM no es válida. Formato esperado: yyyy-mm-dd.
PIX-0510	Invalid Account Type in CRM	The account type returned by CRM is invalid. Expected: CACC, SLRY, SVGS, TRAN, or OTHR.	El tipo de cuenta devuelto por CRM no es válido. Esperado: CACC, SLRY, SVGS, TRAN u OTHR.
PIX-0600	Midaz Insufficient Funds	Insufficient funds in the source account.	Fondos insuficientes en la cuenta de origen.
PIX-0704	Invalid Collection Status	The collection status is invalid or does not allow this operation.	El estado del cobro no es válido o no permite esta operación.
PIX-1008	Provider Invalid Response	Provider returned an invalid response.	El proveedor devolvió una respuesta no válida.
PIX-1010	Provider Unprocessable	Provider cannot process the request.	El proveedor no puede procesar la solicitud.
PIX-1068	Invalid Request Status	The provider reports that the request is in an invalid state for this operation.	El proveedor informa que la solicitud está en un estado no válido para esta operación.
PIX-1069	Cannot Cancel Request	The provider reports that the request cannot be cancelled due to its current state.	El proveedor informa que la solicitud no se puede cancelar debido a su estado actual.
PIX-1083	Cannot Cancel Marker	The provider reports that the marker cannot be cancelled due to its current state.	El proveedor informa que el marcador no se puede cancelar debido a su estado actual.

429

Código	Título	Mensaje	Traducción
PIX-1003	Rate Limit Exceeded	Rate limit exceeded. Please try again later.	Se excedió el límite de tasa. Inténtelo de nuevo más tarde.

500

Código	Título	Mensaje	Traducción
PIX-0000	Internal Server Error	The server encountered an unexpected error. Please try again later.	El servidor encontró un error inesperado. Inténtelo de nuevo más tarde.
PIX-0500	CRM Connection Error	Failed to connect to CRM service.	Error al conectar con el servicio CRM.
PIX-0599	CRM Bad Request	CRM returned a bad request error.	CRM devolvió un error de solicitud incorrecta.
PIX-1007	Provider Internal Error	Provider returned an internal error.	El proveedor devolvió un error interno.
PIX-1099	Provider Unmapped Error	Provider returned an unmapped error.	El proveedor devolvió un error no mapeado.

502

Código	Título	Mensaje	Traducción
PIX-0602	Midaz Connection Error	Failed to connect to Midaz.	Error al conectar con Midaz.
PIX-0650	Fee Service Connection Error	Failed to connect to Fee service.	Error al conectar con el servicio de tarifas.
PIX-1000	Provider Connection Error	Failed to connect to provider.	Error al conectar con el proveedor.

503

Código	Título	Mensaje	Traducción
PIX-0330	Service Unavailable	The decode service is temporarily unavailable.	El servicio de decodificación no está disponible temporalmente.
PIX-1004	Provider Service Unavailable	Provider service is temporarily unavailable.	El servicio del proveedor no está disponible temporalmente.

504

Código	Título	Mensaje	Traducción
PIX-1002	Provider Request Timeout	Provider request timed out.	La solicitud al proveedor superó el tiempo de espera.

CRM

Fees Engine

Pix Directo

Pix Indirecto (BTG)

Lista de errores de Indirect Pix BTG

Errores de Indirect Pix BTG

400

403

404

409

422

429

500

502

503

504

CRM

Fees Engine

Pix Directo

Pix Indirecto (BTG)

​Errores de Indirect Pix BTG

​400

​403

​404

​409

​422

​429

​500

​502

​503

​504

Errores de Indirect Pix BTG

400

403

404

409

422

429

500

502

503

504