Lista de erros do Indirect Pix BTG

Formato do erro

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

Definição dos campos

code – Um identificador único e estável para o erro. Útil para tratamento programático e solicitações de suporte.
title – Um resumo curto e legível do problema.
message – Orientação detalhada para ajudá-lo a resolver o erro.

Essa estrutura garante que você sempre receba feedback acionável quando algo não sair como esperado.

Erros do Indirect Pix BTG

Os seguintes erros podem ocorrer ao interagir com os endpoints do Indirect Pix BTG. Cada erro segue nossa estrutura padrão, facilitando a depuração e a resposta a problemas de forma programática. Consulte as tabelas abaixo para uma lista de possíveis códigos de erro, o que eles significam e como resolvê-los.

400

Código	Título	Mensagem	Tradução
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.	Sua requisição está sem um ou mais headers obrigatórios. Consulte a documentação para garantir que todos os headers necessários estejam incluídos na sua requisição.
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.	Um ou mais valores de header são inválidos. Consulte a documentação para verificar o formato esperado e os valores permitidos para cada header.
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.	Sua requisição está sem um ou mais campos obrigatórios. Consulte a documentação para garantir que todos os campos necessários estejam incluídos na sua requisição.
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.	Sua requisição contém um ou mais campos com valores inválidos. Consulte a documentação para verificar se todos os campos possuem os valores corretos.
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.	Sua requisição contém um ou mais campos com tipo de dado inválido. Consulte a documentação para verificar se todos os campos possuem o tipo correto.
PIX-0006	Unexpected Fields in Request	The request body contains more fields than expected. Please send only the allowed fields as per the documentation.	O corpo da requisição contém mais campos do que o esperado. Envie apenas os campos permitidos conforme a documentação.
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.	Sua requisição está sem um ou mais parâmetros de caminho obrigatórios. Consulte a documentação para garantir que todos os parâmetros de caminho necessários estejam incluídos na sua requisição.
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.	Um ou mais parâmetros de caminho são inválidos. Consulte a documentação para verificar o formato esperado e os valores permitidos para cada parâmetro de caminho.
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.	Sua requisição está sem um ou mais parâmetros de consulta obrigatórios. Consulte a documentação para garantir que todos os parâmetros de consulta necessários estejam incluídos na sua requisição.
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.	Um ou mais parâmetros de consulta são inválidos. Consulte a documentação para verificar o formato esperado e os 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.	O formato do timestamp é inválido. Consulte a documentação para verificar o formato esperado.
PIX-0012	Invalid Metadata	The metadata is invalid. Please refer to the documentation to verify the expected format.	Os metadados são inválidos. Consulte a documentação para verificar o formato esperado.
PIX-0013	Limit Exceeded	The request exceeded the allowed limit.	A requisição excedeu o limite permitido.
PIX-0101	EVP Key Cannot Be Provided	EVP keys cannot be provided manually, they are automatically generated.	Chaves EVP não podem ser fornecidas manualmente, elas são geradas automaticamente.
PIX-0102	Invalid Key Format	Invalid format for the specified keyType.	Formato inválido para o keyType especificado.
PIX-0105	CPF Mismatch	CPF does not match holder document in CRM.	O CPF não corresponde ao documento do titular no CRM.
PIX-0106	CNPJ Mismatch	CNPJ does not match holder document in CRM.	O CNPJ não corresponde ao documento do titular no CRM.
PIX-0107	Pix Key Limit Exceeded for Holder	The key limit has been exceeded for the holder.	O limite de chaves foi excedido para o titular.
PIX-0108	Pix Key Limit Exceeded for Type	The key type limit has been exceeded.	O limite do tipo de chave foi excedido.
PIX-0109	Invalid Opening Date	The opening date in CRM is invalid. Please provide a valid date in the ‘yyyy-mm-dd’ format.	A data de abertura no CRM é inválida. Forneça uma data válida no formato ‘yyyy-mm-dd’.
PIX-0116	Empty Keys Array	The keys array must not be empty.	O array de chaves não pode estar vazio.
PIX-0117	Keys Array Exceeded Limit	The keys array must not exceed 200 items.	O array de chaves não pode exceder 200 itens.
PIX-0118	Key Claim Type Not Allowed	Only PHONE keys are allowed for ownership claims.	Apenas chaves PHONE são permitidas para reivindicações de posse.
PIX-0120	Key Does Not Exist	The Pix key does not exist in DICT.	A chave Pix não existe no DICT.
PIX-0121	Pix Key Locked By Claim	The Pix key is currently locked by another claim process.	A chave Pix está atualmente bloqueada por outro processo de reivindicação.
PIX-0122	EVP Key Cannot Be Claimed	EVP keys cannot be claimed.	Chaves EVP não podem ser reivindicadas.
PIX-0124	Cannot Claim Key	It is not possible to claim this key.	Não é possível reivindicar esta chave.
PIX-0151	Invalid CID Format	The CID must be a 64-character lowercase hexadecimal string.	O CID deve ser uma string hexadecimal em letras minúsculas com 64 caracteres.
PIX-0201	Report Details Too Long	The report details exceed the maximum allowed length of 2000 characters.	Os detalhes do relatório excedem o comprimento máximo permitido de 2000 caracteres.
PIX-0202	Invalid Email Format	The email format is invalid.	O formato do e-mail é inválido.
PIX-0203	Invalid Phone Format	The phone format is invalid.	O formato do telefone é inválido.
PIX-0205	Invalid Transaction ID Format	The transaction ID format must match a E2E ID format.	O formato do ID de transação deve corresponder ao formato de E2E ID.
PIX-0208	Infraction Fraud Type Required	The fraud type is required when analysis result is AGREED.	O tipo de fraude é obrigatório quando o resultado da análise é AGREED.
PIX-0209	Infraction Analysis Details Required	The analysis details are required when fraud type is OTHER.	Os detalhes da análise são obrigatórios quando o tipo de fraude é OTHER.
PIX-0210	Infraction Analysis Details Too Long	The analysis details exceed the maximum allowed length of 2000 characters.	Os detalhes da análise excedem o comprimento máximo permitido de 2000 caracteres.
PIX-0212	Transaction Too Old	The transaction occurred more than 80 days ago and cannot be reported.	A transação ocorreu há mais de 80 dias e não pode ser reportada.
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).	A transação não é uma transação de devolução. O cancelamento de infrações de devolução só pode ser usado para transações de devolução (pacs.004).
PIX-0218	Cancellation Reason Too Long	The cancellation reason exceeds the maximum allowed length of 500 characters.	O motivo do cancelamento excede o comprimento máximo permitido de 500 caracteres.
PIX-0219	Invalid ID Format	The ID must be a valid UUID format.	O ID deve estar em um formato UUID válido.
PIX-0220	Invalid Date Range Order	The modified_before timestamp must be after modified_after timestamp.	O timestamp modified_before deve ser posterior ao timestamp modified_after.
PIX-0221	Refund Transaction Too Old	The refund transaction occurred more than 30 days ago and cannot be reported for cancellation.	A transação de devolução ocorreu há mais de 30 dias e não pode ser reportada para cancelamento.
PIX-0222	Invalid Situation Type	Refund cancellation infraction reports must use situationType OTHER.	Relatórios de infração de cancelamento de devolução devem 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).	O valor da devolução deve estar em formato decimal com exatamente 2 casas decimais (ex.: 100.50).
PIX-0231	Refund Details Too Long	The refund details exceed the maximum allowed length of 2000 characters.	Os detalhes da devolução excedem o comprimento máximo permitido de 2000 caracteres.
PIX-0232	Refund Amount Exceeds Transaction	The refund amount cannot exceed the original transaction amount.	O valor da devolução não pode exceder o valor da transação original.
PIX-0233	Missing Refund Details	The refundDetails field is required when refundReason is OPERATIONAL_FLAW.	O campo refundDetails é obrigatório quando refundReason é OPERATIONAL_FLAW.
PIX-0235	Missing Refund Transaction ID	The refund transaction ID is required when the refund is accepted (TOTALLY_ACCEPTED or PARTIALLY_ACCEPTED).	O ID da transação de devolução é obrigatório quando a devolução é aceita (TOTALLY_ACCEPTED ou PARTIALLY_ACCEPTED).
PIX-0237	Missing Rejection Reason	The refundRejectionReason is required when analysisResult is REJECTED.	O refundRejectionReason é obrigatório quando analysisResult é REJECTED.
PIX-0238	Missing Analysis Details	The analysisDetails field is required when analysisResult is REJECTED and refundRejectionReason is INVALID_REQUEST.	O campo analysisDetails é obrigatório quando analysisResult é REJECTED e refundRejectionReason é 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.	Uma solicitação de devolução com motivo FRAUD requer um relatório de infração prévio que tenha sido encerrado com 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.	O relatório de infração foi encerrado há mais de 72 horas. Solicitações de devolução devem ser criadas dentro de 72 horas após o encerramento do relatório de infração.
PIX-0245	Date Range Exceeds 90 Days	The date range between modifiedAfter and modifiedBefore cannot exceed 90 days.	O intervalo de datas entre modifiedAfter e modifiedBefore não pode exceder 90 dias.
PIX-0260	Invalid Tax ID Format	The taxIdNumber must be a valid CPF (11 digits) or CNPJ (14 digits) format.	O taxIdNumber deve ser um CPF (11 dígitos) ou CNPJ (14 dígitos) válido.
PIX-0261	Invalid Key Format	The key must be between 8 and 32 characters.	A chave deve ter entre 8 e 32 caracteres.
PIX-0280	Invalid Key Value	The key value is invalid or exceeds the maximum length of 77 characters.	O valor da chave é inválido ou excede o comprimento máximo de 77 caracteres.
PIX-0300	Invalid EMV Format	The EMV payload does not follow the valid EMV QCO format specification.	O payload EMV não segue a especificação válida do formato EMV QCO.
PIX-0301	Corrupted QR Code	The QR Code data is corrupted and cannot be decoded.	Os dados do QR Code estão corrompidos e não podem ser decodificados.
PIX-0302	Unsupported QR Code Version	The QR Code version or format is not supported.	A versão ou formato do QR Code não é suportado.
PIX-0303	Invalid Payment Date	The payment date exceeds the valid payment period.	A data de pagamento excede o período de pagamento válido.
PIX-0304	Invalid Amount	The amount must be greater than zero and follow the 0.00 format with two decimals.	O valor deve ser maior que zero e seguir o formato 0.00 com duas casas decimais.
PIX-0305	Invalid City	The city must contain only letters and spaces.	A cidade deve conter apenas letras e espaços.
PIX-0306	Invalid TxID Format	The txId format is invalid.	O formato do txId é inválido.
PIX-0307	Receiver Key Required	The receiverKey is required.	O receiverKey é obrigatório.
PIX-0309	Invalid Category Code Format	The categoryCode must be numeric.	O categoryCode deve ser numérico.
PIX-0310	Invalid Merchant Name	The merchant name is required.	O nome do comerciante é obrigatório.
PIX-0311	Receiver Key Not Found	The receiverKey was not found.	O receiverKey não foi encontrado.
PIX-0312	Invalid Receiver Key	The receiverKey is invalid.	O receiverKey é inválido.
PIX-0314	EMV Required	The EMV is required.	O EMV é obrigatório.
PIX-0315	Empty EMV Payload	The EMV payload cannot be empty.	O payload EMV não pode estar vazio.
PIX-0317	Invalid City Code	The city code is invalid.	O código da cidade é inválido.
PIX-0319	Receiver Key Not Associated	The receiver key is not associated with the account.	A chave do recebedor não está associada à conta.
PIX-0320	Invalid Merchant Name	The merchant name is required.	O nome do comerciante é obrigatório.
PIX-0321	Invalid Merchant City	The merchant city must contain only letters and spaces.	A cidade do comerciante deve conter apenas letras e espaços.
PIX-0322	Invalid Merchant Category Code	The merchant category code must be numeric.	O código de categoria do comerciante deve ser numérico.
PIX-0324	Invalid Amount Value	The amount is not a valid decimal.	O valor não é um decimal válido.
PIX-0327	Invalid Client Request ID	The client request ID must be a valid UUID.	O ID de requisição do cliente deve ser um UUID válido.
PIX-0328	Invalid Image Type	The image type must be one of: Gif, Jpeg, Png.	O tipo de imagem deve ser um dos seguintes: Gif, Jpeg, Png.
PIX-0329	Invalid Pixels Per Module	The pixels per module value is out of bounds.	O valor de pixels por módulo está fora dos limites.
PIX-0400	Description Too Long	The description field exceeds the maximum allowed length of 140 characters.	O campo de descrição excede o comprimento máximo permitido de 140 caracteres.
PIX-0401	Description Contains HTML	The description contains invalid HTML characters.	A descrição contém caracteres HTML inválidos.
PIX-0402	Invalid Amount Format	The amount must be in format 0.00 with exactly 2 decimal places (1-10 digits before decimal).	O valor deve estar no formato 0.00 com exatamente 2 casas decimais (1-10 dígitos antes do decimal).
PIX-0403	Amount Must Be Positive	The amount must be greater than zero.	O valor deve ser maior que zero.
PIX-0404	Invalid UUID Format	The UUID format is invalid.	O formato do UUID é inválido.
PIX-0405	Invalid End-to-End ID Format	The end-to-end ID format is invalid.	O formato do end-to-end ID é invá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.	Transferências INTRA PSP (mesmo participante) não são suportadas. O ISPB do banco de destino não pode ser o mesmo do PSP de origem.
PIX-0414	Destination Required	Destination is required for MANUAL initiation type.	O destino é obrigatório para o tipo de iniciação MANUAL.
PIX-0415	Invalid Initiation Type	The initiation type is invalid.	O tipo de iniciação é inválido.
PIX-0416	Key Required	Key is required for KEY initiation type.	A chave é obrigatória para o tipo de iniciação KEY.
PIX-0417	EMV Required	EMV is required for QR_CODE initiation type.	O EMV é obrigatório para o tipo de iniciação QR_CODE.
PIX-0418	Invalid Destination	The destination is invalid for MANUAL initiation type.	O destino é inválido para o tipo de iniciação MANUAL.
PIX-0422	Amount Mismatch	The amount does not match the fixed amount from QR code.	O valor não corresponde ao valor fixo do QR Code.
PIX-0424	Invalid Amount Value	The amount must be greater than zero.	O valor deve ser maior que zero.
PIX-0440	Original Transfer Not Cashin	Only cashin transfers can be refunded with cashout refunds.	Apenas transferências cashin podem ser devolvidas com devoluções cashout.
PIX-0442	Refund Exceeds Original	The refund amount exceeds the original transaction amount.	O valor da devolução excede o valor da transação original.
PIX-0443	Invalid Refund Reason	The refund reason code is invalid.	O código do motivo de devolução é inválido.
PIX-0444	Refund Exceeds Net Amount	The partial refund amount exceeds net amount available after fees.	O valor da devolução parcial excede o valor líquido disponível após taxas.
PIX-0450	Destination Bank Required	The destination bank is required.	O banco de destino é obrigatório.
PIX-0451	Destination Bank Invalid	The destination bank must be 8 digits.	O banco de destino deve ter 8 dígitos.
PIX-0452	Destination Branch Required	The destination branch is required.	A agência de destino é obrigatória.
PIX-0453	Destination Account Required	The destination account is required.	A conta de destino é obrigatória.
PIX-0454	Destination Account Type Invalid	The destination account type is invalid.	O tipo de conta de destino é inválido.
PIX-0455	Destination Document Required	The destination document is required.	O documento de destino é obrigatório.
PIX-0456	Destination Document Invalid	The destination document is invalid: must be CPF (11 digits) or CNPJ (14 digits).	O documento de destino é inválido: deve ser CPF (11 dígitos) ou CNPJ (14 dígitos).
PIX-0457	Destination Name Required	The destination name is required.	O nome do destinatário é obrigatório.
PIX-0458	Destination Person Type Invalid	The destination person type is invalid.	O tipo de pessoa do destinatário é inválido.
PIX-0459	Destination Person Type Mismatch	Person type does not match document: CPF requires NATURAL_PERSON, CNPJ requires LEGAL_PERSON.	O tipo de pessoa não corresponde ao documento: CPF requer NATURAL_PERSON, CNPJ requer LEGAL_PERSON.
PIX-0700	Collection Not Found	The collection was not found.	A cobrança não foi encontrada.
PIX-0701	Duplicate Collection TxID	A collection with this txId already exists for the receiver.	Uma cobrança com este txId já existe para o recebedor.
PIX-0703	Invalid Collection Type	The collection type is invalid.	O tipo de cobrança é inválido.
PIX-0705	Invalid Collection Amount	The collection amount is invalid.	O valor da cobrança é inválido.
PIX-0706	Invalid Collection Expiration / Receiver Key Not Owned	The collection expiration is invalid / The receiver key is not associated with the account.	A expiração da cobrança é inválida / A chave do recebedor não está associada à conta.
PIX-0707	Invalid Due Date / Invalid Debtor	The due date is invalid / The debtor information is invalid.	A data de vencimento é inválida / As informações do devedor são inválidas.
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.	A expiração excede o máximo permitido: 30 dias (2.592.000 segundos) / A cobrança não possui ID 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.	O txID é inválido ou não pode estar vazio / O motivo de exclusão deve ser DELETED_BY_USER ou DELETED_BY_PSP.
PIX-0710	Invalid Receiver Document	The receiver document is invalid or cannot be empty.	O documento do recebedor é inválido ou não pode estar vazio.
PIX-0711	Invalid Receiver Name	The receiver name is invalid or cannot be empty.	O nome do recebedor é inválido ou não pode estar vazio.
PIX-0712	Invalid Receiver Address	The receiver address is required.	O endereço do recebedor é obrigatório.
PIX-0713	Invalid Debtor Name	The debtor name is invalid or cannot be empty.	O nome do devedor é inválido ou não pode estar vazio.
PIX-0714	Invalid CPF Format	The CPF format is invalid: must be exactly 11 digits.	O formato do CPF é inválido: deve ter exatamente 11 dígitos.
PIX-0715	Invalid CNPJ Format	The CNPJ format is invalid: must be exactly 14 digits.	O formato do CNPJ é inválido: deve ter exatamente 14 dígitos.
PIX-0716	Invalid Account ID	The account ID is invalid or cannot be empty.	O ID da conta é inválido ou não pode estar vazio.
PIX-0717	Invalid Pactual ID	The pactual ID is invalid or cannot be empty.	O ID pactual é inválido ou não pode estar vazio.
PIX-0718	Invalid Location ID	The location ID is invalid or cannot be empty.	O ID de localização é inválido ou não pode estar vazio.
PIX-0719	Invalid Fine	The fine configuration is incomplete: both type and value must be provided.	A configuração de multa está incompleta: tipo e valor devem ser fornecidos.
PIX-0720	Invalid Interest	The interest configuration is incomplete: both type and value must be provided.	A configuração de juros está incompleta: tipo e valor devem ser fornecidos.
PIX-0721	Invalid Discount	The discount configuration is incomplete: type, value and days before due must be provided.	A configuração de desconto está incompleta: tipo, valor e dias antes do vencimento devem ser fornecidos.
PIX-0722	Invalid Abatement	The abatement configuration is incomplete: both type and value must be provided.	A configuração de abatimento está incompleta: tipo e valor devem ser fornecidos.
PIX-0723	Too Many Additional Info	The number of additional info items exceeds the maximum allowed: 50.	O número de itens de informações adicionais excede o máximo permitido: 50.
PIX-0724	PIX Troco Amount Mismatch	PIX Troco transaction amount must equal original amount.	O valor da transação PIX Troco deve ser igual ao valor original.
PIX-0725	Invalid PIX Saque Configuration	PIX Saque cannot have transaction amount, only withdrawal amount.	PIX Saque não pode ter valor de transação, apenas valor de saque.
PIX-0727	Debtor Document Mismatch	The payment debtor document does not match the collection debtor.	O documento do devedor do pagamento não corresponde ao devedor da cobrança.
PIX-0728	Type Mismatch	The payment type does not match the collection type.	O tipo do pagamento não corresponde ao tipo da cobrança.
PIX-0729	Collection Amount Mismatch	The payment amount does not match the collection amount.	O valor do pagamento não corresponde ao valor da cobrança.
PIX-1009	Provider Bad Request	Provider rejected the request due to invalid data.	O provedor rejeitou a requisição devido a dados inválidos.
PIX-1081	Invalid Fraud Type	The provider reports that the fraud type is not valid for this operation.	O provedor informa que o tipo de fraude não é válido para esta operação.

403

Código	Título	Mensagem	Tradução
PIX-0115	EVP Key Cannot Be Updated	EVP keys cannot be updated.	Chaves EVP não podem ser atualizadas.
PIX-0126	Must Be Donor Participant	The claim must be from the donor participant to confirm.	A reivindicação deve ser do participante doador para confirmar.
PIX-0135	Donor Cannot Cancel Open Claim	The donor participant cannot cancel a claim in OPEN status.	O participante doador não pode cancelar uma reivindicação com status OPEN.
PIX-0141	Donor Cannot Cancel Confirmed Portability	The donor cannot cancel a confirmed portability claim.	O doador não pode cancelar uma reivindicação de portabilidade confirmada.
PIX-0145	Unknown Actor	The participant is neither the claimer nor the donor.	O participante não é nem o reivindicante nem o doador.
PIX-0147	Must Be Claimer Participant	Only the claimer participant can complete a claim.	Apenas o participante reivindicante pode concluir uma reivindicação.
PIX-0213	Unauthorized to Open Refund Request	A refund request infraction report can only be opened by the payer’s PSP.	Um relatório de infração de solicitação de devolução só pode ser aberto pelo PSP do pagador.
PIX-0214	Unauthorized to Open Cancellation Report	A cancellation of refund infraction report can only be opened by the payee’s PSP.	Um relatório de infração de cancelamento de devolução só pode ser aberto pelo PSP do recebedor.
PIX-0216	Unauthorized to Close Refund Request	A refund request infraction report must be closed by the payee’s PSP.	Um relatório de infração de solicitação de devolução deve ser encerrado pelo PSP do recebedor.
PIX-0217	Unauthorized to Close Cancellation Report	A cancellation of refund infraction report must be closed by the payer’s PSP.	Um relatório de infração de cancelamento de devolução deve ser encerrado pelo PSP do pagador.
PIX-0431	Account Blocked	The account is blocked and cannot perform transactions.	A conta está bloqueada e não pode realizar transações.
PIX-0501	CRM Authentication Error	Failed to authenticate with CRM service.	Falha ao autenticar com o serviço CRM.
PIX-0601	Midaz Account Blocked	The account is blocked and cannot perform transactions.	A conta está bloqueada e não pode realizar transações.
PIX-0726	Collection Update Not Allowed	Updates are not allowed for this collection.	Atualizações não são permitidas para esta cobrança.
PIX-1001	Provider Authentication Error	Failed to authenticate with provider.	Falha ao autenticar com o provedor.

404

Código	Título	Mensagem	Tradução
PIX-0112	Entry Not Found	The entry was not found.	A entrada não foi encontrada.
PIX-0113	Claim Not Found	The claim was not found.	A reivindicação não foi encontrada.
PIX-0150	CID File Not Found	The specified CID file was not found or is not ready for download.	O arquivo CID especificado não foi encontrado ou não está pronto para download.
PIX-0152	CID Not Found	The specified CID was not found in DICT.	O CID especificado não foi encontrado no DICT.
PIX-0200	Infraction Report Not Found	The infraction report was not found.	O relatório de infração não foi encontrado.
PIX-0211	Transaction Not Found	The specified transaction was not found.	A transação especificada não foi encontrada.
PIX-0234	Refund Request Not Found	The specified refund request was not found.	A solicitação de devolução especificada não foi encontrada.
PIX-0262	Fraud Marker Not Found	The specified fraud marker was not found.	O marcador de fraude especificado não foi encontrado.
PIX-0316	EMV Not Found	The EMV QR Code was not found.	O EMV QR Code não foi encontrado.
PIX-0318	BR Code Not Found	The requested BR Code was not found.	O BR Code solicitado não foi encontrado.
PIX-0407	Transfer Account Mismatch	The transfer does not belong to the specified account.	A transferência não pertence à conta especificada.
PIX-0410	Initiation Not Found	The payment initiation was not found.	A iniciação de pagamento não foi encontrada.
PIX-0420	Cashout Not Found	The cashout transaction was not found.	A transação cashout não foi encontrada.
PIX-0425	Cashin Not Found	The cashin transaction was not found.	A transação cashin não foi encontrada.
PIX-0426	Transfer Not Found	The transfer was not found.	A transferência não foi encontrada.
PIX-0427	Refund Not Found	The refund was not found.	A devolução não foi encontrada.
PIX-0430	Account Not Found	The account was not found in ledger.	A conta não foi encontrada no ledger.
PIX-0502	Account Not Found in CRM	The account was not found in CRM for the given criteria.	A conta não foi encontrada no CRM para os critérios informados.
PIX-0503	Holder Not Found in CRM	The holder was not found in CRM.	O titular não foi encontrado no CRM.
PIX-1005	Key Not Found	The Pix key was not found.	A chave Pix não foi encontrada.
PIX-1090	Person Statistics Not Found	The provider reports that no statistics were found for the specified tax ID.	O provedor informa que não foram encontradas estatísticas para o documento fiscal especificado.
PIX-1091	Key Statistics Not Found	The provider reports that no statistics were found for the specified Pix key.	O provedor informa que não foram encontradas estatísticas para a chave Pix especificada.

409

Código	Título	Mensagem	Tradução
PIX-0103	Pix Key Already Exists	The Pix key is already registered.	A chave Pix já 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.	A chave Pix já está registrada para outro titular. Inicie uma reivindicação de posse para adquirir esta chave.
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.	A chave Pix já está vinculada a outra conta do mesmo titular. Inicie uma solicitação de portabilidade para transferir esta chave.
PIX-0119	Pix Key Already Claimed	You already have a claim in progress for this key.	Você já possui uma reivindicação em andamento para esta chave.
PIX-0123	Key Already Belongs to Holder	The Pix key is already linked to the requesting holder.	A chave Pix já está vinculada ao titular solicitante.
PIX-0160	Claim Already Completed	The claim has already been completed.	A reivindicação já foi concluída.
PIX-0161	Claim Is Cancelled	The claim has been cancelled and cannot be completed.	A reivindicação foi cancelada e não pode ser concluída.
PIX-0204	Duplicate Infraction Report	An infraction report already exists for this transaction.	Já existe um relatório de infração para esta transação.
PIX-0242	Duplicate Refund Request	A refund request already exists for this transaction.	Já existe uma solicitação de devolução para esta transação.
PIX-0412	Initiation Already Used	The payment initiation has already been processed.	A iniciação de pagamento já foi processada.
PIX-0423	Duplicate End-to-End ID	A transaction with this end-to-end ID already exists.	Já existe uma transação com este end-to-end ID.
PIX-0428	Duplicate Refund	A refund already exists for this transaction.	Já existe uma devolução para esta transação.
PIX-0702	Collection Already Deleted	The collection has already been deleted.	A cobrança já foi excluída.
PIX-1006	Key Already Exists	The Pix key already exists.	A chave Pix já existe.
PIX-1065	Duplicate Refund Request	The provider reports that a refund request already exists for this transaction.	O provedor informa que já existe uma solicitação de devolução para esta transação.
PIX-1080	Duplicate Fraud Marker	The provider reports that a fraud marker already exists for this document and key combination.	O provedor informa que já existe um marcador de fraude para esta combinação de documento e chave.

422

Código	Título	Mensagem	Tradução
PIX-0114	Key In Custody Account	The entry queried is in custody of the participant making the query.	A entrada consultada está sob custódia do participante que realizou a consulta.
PIX-0125	Waiting Resolution Status	The claim must be in WAITING_RESOLUTION status to execute the action.	A reivindicação deve estar com status WAITING_RESOLUTION para executar a ação.
PIX-0127	Portability Cannot Be Confirmed	Portability claims cannot be confirmed with DEFAULT_OPERATION reason.	Reivindicações de portabilidade não podem ser confirmadas com motivo DEFAULT_OPERATION.
PIX-0128	Ownership Cannot Be Confirmed	Ownership claims cannot be confirmed with DEFAULT_OPERATION reason before the resolution period has ended.	Reivindicações de posse não podem ser confirmadas com motivo DEFAULT_OPERATION antes do término do período de resolução.
PIX-0134	Claim Cannot Be Cancelled	The claim cannot be cancelled in current status.	A reivindicação não pode ser cancelada no status atual.
PIX-0136	Invalid Reason for Claimer	The claimer cannot cancel with the provided reason in this status.	O reivindicante não pode cancelar com o motivo fornecido neste status.
PIX-0137	Invalid Reason for Donor	The donor cannot cancel with the provided reason in this status.	O doador não pode cancelar com o motivo fornecido neste status.
PIX-0142	Resolution Period Not Ended	The resolution period has not ended yet for DEFAULT_OPERATION cancellation.	O período de resolução ainda não terminou para cancelamento por DEFAULT_OPERATION.
PIX-0143	Ownership Cancel Period Not Ended	Ownership claims with DEFAULT_OPERATION can only be cancelled after CompletionPeriodEnd + 16 days.	Reivindicações de posse com DEFAULT_OPERATION só podem ser canceladas após CompletionPeriodEnd + 16 dias.
PIX-0144	Donor Cancel Period Expired	The donor can only cancel with FRAUD while CompletionPeriodEnd has not passed.	O doador só pode cancelar com FRAUD enquanto CompletionPeriodEnd não tiver passado.
PIX-0146	Claim Not Confirmed	The claim must be in CONFIRMED status.	A reivindicação deve estar com status CONFIRMED.
PIX-0148	Ownership Completion Period Not Ended	Ownership claims can only be completed after the completion period has ended.	Reivindicações de posse só podem ser concluídas após o término do período de conclusão.
PIX-0149	Claim Not Acknowledgeable	The claim does not meet acknowledgement preconditions (must be OPEN status and caller must be the donor participant).	A reivindicação não atende às pré-condições de reconhecimento (deve estar com status OPEN e o chamador deve ser o participante doador).
PIX-0162	Claim Cannot Be Completed	The claim cannot be completed in its current status.	A reivindicação não pode ser concluída no status atual.
PIX-0163	Completion Period Not Set	The completion period is not set for this claim.	O período de conclusão não está definido para esta reivindicação.
PIX-0164	Completion Period Expired	The completion period has expired for this claim.	O período de conclusão expirou para esta reivindicação.
PIX-0165	Entry Inactive	The entry is not in active status.	A entrada não está com status ativo.
PIX-0206	Infraction Report Cannot Be Cancelled	The infraction report cannot be cancelled in current status.	O relatório de infração não pode ser cancelado no status atual.
PIX-0207	Infraction Report Cannot Be Closed	The infraction report cannot be closed in current status.	O relatório de infração não pode ser encerrado no status atual.
PIX-0223	Infraction Report Cannot Be Acknowledged	The infraction report cannot be acknowledged in current status.	O relatório de infração não pode ser reconhecido no status atual.
PIX-0236	Invalid Request Status	The request cannot be closed because it is already in CLOSED or CANCELLED status.	A solicitação não pode ser encerrada porque já está com status CLOSED ou CANCELLED.
PIX-0239	Cannot Cancel Request	The request cannot be cancelled because it is already in CLOSED or CANCELLED status.	A solicitação não pode ser cancelada porque já está com status CLOSED ou CANCELLED.
PIX-0243	Refund Request Already Closed	The refund request is already closed.	A solicitação de devolução já está encerrada.
PIX-0244	Refund Request Already Cancelled	The refund request is already cancelled.	A solicitação de devolução já está cancelada.
PIX-0263	Cannot Cancel Marker	The fraud marker cannot be cancelled because it is already in CANCELLED status.	O marcador de fraude não pode ser cancelado porque já está com status CANCELLED.
PIX-0411	Initiation Expired	The payment initiation has expired.	A iniciação de pagamento expirou.
PIX-0413	Initiation Invalid State	The payment initiation is in an invalid state.	A iniciação de pagamento está em um estado inválido.
PIX-0421	Insufficient Balance	Insufficient balance to complete the transaction.	Saldo insuficiente para concluir a transação.
PIX-0441	Original Transfer Not Complete	Only completed transactions can be refunded.	Apenas transações concluídas podem ser devolvidas.
PIX-0445	Invalid Transaction Status	Only completed transactions can be refunded.	Apenas transações concluídas podem ser devolvidas.
PIX-0470	Invalid Status Transition	The status transition is invalid.	A transição de status é inválida.
PIX-0471	Transfer Already Terminal	The transaction is already in a terminal state.	A transação já está em um estado terminal.
PIX-0472	Cannot Cancel	Cannot cancel transaction in current status.	Não é possível cancelar a transação no status atual.
PIX-0473	Already Terminal	The operation is already in a terminal state.	A operação já está em um estado terminal.
PIX-0504	Invalid Branch in CRM	The branch returned by CRM is invalid. Expected exactly 4 digits.	A agência retornada pelo CRM é inválida. Esperado exatamente 4 dígitos.
PIX-0505	Invalid Account Number in CRM	The account number returned by CRM is invalid. Expected 1-20 digits.	O número da conta retornado pelo CRM é inválido. Esperado de 1 a 20 dígitos.
PIX-0506	Invalid Document in CRM	The document (CPF/CNPJ) returned by CRM is invalid.	O documento (CPF/CNPJ) retornado pelo CRM é inválido.
PIX-0507	Invalid Name in CRM	The name returned by CRM is invalid or exceeds 120 characters.	O nome retornado pelo CRM é inválido ou excede 120 caracteres.
PIX-0508	Invalid Trade Name in CRM	The trade name returned by CRM is invalid or exceeds 100 characters.	O nome fantasia retornado pelo CRM é inválido ou excede 100 caracteres.
PIX-0509	Invalid Opening Date in CRM	The opening date returned by CRM is invalid. Expected format: yyyy-mm-dd.	A data de abertura retornada pelo CRM é invá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.	O tipo de conta retornado pelo CRM é inválido. Esperado: CACC, SLRY, SVGS, TRAN ou OTHR.
PIX-0600	Midaz Insufficient Funds	Insufficient funds in the source account.	Fundos insuficientes na conta de origem.
PIX-0704	Invalid Collection Status	The collection status is invalid or does not allow this operation.	O status da cobrança é inválido ou não permite esta operação.
PIX-1008	Provider Invalid Response	Provider returned an invalid response.	O provedor retornou uma resposta inválida.
PIX-1010	Provider Unprocessable	Provider cannot process the request.	O provedor não pode processar a requisição.
PIX-1068	Invalid Request Status	The provider reports that the request is in an invalid state for this operation.	O provedor informa que a solicitação está em um estado inválido para esta operação.
PIX-1069	Cannot Cancel Request	The provider reports that the request cannot be cancelled due to its current state.	O provedor informa que a solicitação não pode ser cancelada devido ao seu estado atual.
PIX-1083	Cannot Cancel Marker	The provider reports that the marker cannot be cancelled due to its current state.	O provedor informa que o marcador não pode ser cancelado devido ao seu estado atual.

429

Código	Título	Mensagem	Tradução
PIX-1003	Rate Limit Exceeded	Rate limit exceeded. Please try again later.	Limite de requisições excedido. Tente novamente mais tarde.

500

Código	Título	Mensagem	Tradução
PIX-0000	Internal Server Error	The server encountered an unexpected error. Please try again later.	O servidor encontrou um erro inesperado. Tente novamente mais tarde.
PIX-0500	CRM Connection Error	Failed to connect to CRM service.	Falha ao conectar com o serviço CRM.
PIX-0599	CRM Bad Request	CRM returned a bad request error.	O CRM retornou um erro de requisição inválida.
PIX-1007	Provider Internal Error	Provider returned an internal error.	O provedor retornou um erro interno.
PIX-1099	Provider Unmapped Error	Provider returned an unmapped error.	O provedor retornou um erro não mapeado.

502

Código	Título	Mensagem	Tradução
PIX-0602	Midaz Connection Error	Failed to connect to Midaz.	Falha ao conectar com o Midaz.
PIX-0650	Fee Service Connection Error	Failed to connect to Fee service.	Falha ao conectar com o serviço de taxas.
PIX-1000	Provider Connection Error	Failed to connect to provider.	Falha ao conectar com o provedor.

503

Código	Título	Mensagem	Tradução
PIX-0330	Service Unavailable	The decode service is temporarily unavailable.	O serviço de decodificação está temporariamente indisponível.
PIX-1004	Provider Service Unavailable	Provider service is temporarily unavailable.	O serviço do provedor está temporariamente indisponível.

504

Código	Título	Mensagem	Tradução
PIX-1002	Provider Request Timeout	Provider request timed out.	A requisição ao provedor excedeu o tempo limite.

CRM

Fees Engine

Pix Direto

Pix Indireto (BTG)

Lista de erros do Indirect Pix BTG

Erros do Indirect Pix BTG

400

403

404

409

422

429

500

502

503

504

CRM

Fees Engine

Pix Direto

Pix Indireto (BTG)

​Erros do Indirect Pix BTG

​400

​403

​404

​409

​422

​429

​500

​502

​503

​504

Erros do Indirect Pix BTG

400

403

404

409

422

429

500

502

503

504