{
"code": "<error_code>",
"title": "<error_title>",
"message": "<error_message>"
}
code– Um identificador estável e único para o erro. Útil para tratamento programático e para solicitações de suporte.title– Um resumo curto e legível do problema.message– Orientação detalhada para ajudar você a resolver o erro.
Erros do Pix Indireto
Os erros a seguir podem ocorrer ao interagir com os endpoints do Pix Indireto. Cada erro segue nossa estrutura padrão.
Erro interno do servidor
code | title | message |
|---|---|---|
| PIX-0000 | Erro interno do servidor | O servidor encontrou um erro inesperado. Tente novamente mais tarde. |
Erros de middleware
code | title | message |
|---|---|---|
| PIX-0001 | Cabeçalhos ausentes na requisição | Sua requisição está sem um ou mais parâmetros de cabeçalho obrigatórios. Consulte a documentação para garantir que todos os parâmetros de cabeçalho necessários estejam incluídos na sua requisição. |
| PIX-0002 | Valor de cabeçalho inválido | Um ou mais valores de cabeçalho são inválidos. Consulte a documentação para verificar o formato e os valores permitidos esperados para cada cabeçalho. |
| PIX-0003 | Campos ausentes na requisição | 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 | Valores de campo inválidos na requisição | Sua requisição contém um ou mais campos com valores inválidos. Consulte a documentação para verificar se todos os campos têm os valores corretos. |
| PIX-0005 | Tipo de campo inválido na requisição | Sua requisição contém um ou mais campos com um tipo de dado inválido. Consulte a documentação para verificar se todos os campos têm o tipo correto. |
| PIX-0006 | Campos inesperados na requisição | O corpo da requisição contém mais campos do que o esperado. Envie somente os campos permitidos conforme a documentação. |
| PIX-0007 | Parâmetros de caminho ausentes na requisição | 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 | Parâmetro de caminho inválido na requisição | Um ou mais parâmetros de caminho são inválidos. Consulte a documentação para verificar o formato e os valores permitidos esperados para cada parâmetro de caminho. |
| PIX-0009 | Parâmetros de consulta ausentes na requisição | 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 | Parâmetro de consulta inválido na requisição | Um ou mais parâmetros de consulta são inválidos. Consulte a documentação para verificar o formato e os valores permitidos esperados para cada parâmetro de consulta. |
| PIX-0011 | Formato de timestamp inválido | O formato do timestamp é inválido. Consulte a documentação para verificar o formato esperado. |
| PIX-0012 | Metadados inválidos | Os metadados são inválidos. Consulte a documentação para verificar o formato esperado. |
| PIX-0013 | Limite excedido | A requisição excedeu o limite permitido. |
Erros do DICT
code | title | message |
|---|---|---|
| PIX-0101 | Chave EVP não pode ser informada | Chaves EVP não podem ser informadas manualmente, elas são geradas automaticamente. |
| PIX-0102 | Formato de chave inválido | Formato inválido para o keyType especificado. |
| PIX-0103 | Chave Pix já existe | A chave Pix já está registrada. |
| PIX-0105 | CPF não corresponde | O CPF não corresponde ao documento do titular no CRM. |
| PIX-0106 | CNPJ não corresponde | O CNPJ não corresponde ao documento do titular no CRM. |
| PIX-0107 | Limite de chaves Pix excedido para o titular | O limite de chaves foi excedido para o titular. |
| PIX-0108 | Limite de chaves Pix excedido para o tipo | O limite do tipo de chave foi excedido. |
| PIX-0109 | Data de abertura inválida | A data de abertura no CRM é inválida. Informe uma data válida no formato ‘yyyy-mm-dd’. |
| PIX-0110 | Chave Pix pertence a outro titular | A chave Pix já está registrada para outro titular. Inicie uma reivindicação de posse para adquirir esta chave. |
| PIX-0111 | Chave Pix já vinculada a outra conta | A chave Pix já está vinculada a outra conta do mesmo titular. Inicie uma solicitação de portabilidade para transferir esta chave. |
| PIX-0112 | Vínculo não encontrado | O vínculo não foi encontrado. |
| PIX-0113 | Reivindicação não encontrada | A reivindicação não foi encontrada. |
| PIX-0114 | Chave em conta de custódia | O vínculo consultado está sob custódia do participante que faz a consulta. |
| PIX-0115 | Chave EVP não pode ser atualizada | Chaves EVP não podem ser atualizadas. |
| PIX-0116 | Array de chaves vazio | O array de chaves não pode estar vazio. |
| PIX-0117 | Array de chaves excedeu o limite | O array de chaves não pode exceder 200 itens. |
| PIX-0118 | Tipo de chave não permitido para reivindicação | Somente chaves PHONE são permitidas para reivindicações de posse. |
| PIX-0119 | Chave Pix já reivindicada | Você já tem uma reivindicação em andamento para esta chave. |
| PIX-0120 | Chave não existe | A chave Pix não existe no DICT. |
| PIX-0121 | Chave Pix travada por reivindicação | A chave Pix está atualmente travada por outro processo de reivindicação. |
| PIX-0122 | Chave EVP não pode ser reivindicada | Chaves EVP não podem ser reivindicadas. |
| PIX-0123 | Chave já pertence ao titular | A chave Pix já está vinculada ao titular que faz a requisição. |
| PIX-0124 | Não é possível reivindicar a chave | Não é possível reivindicar esta chave. |
| PIX-0165 | Vínculo inativo | O vínculo não está com status ativo. |
Erros de reivindicação (confirmação)
code | title | message |
|---|---|---|
| PIX-0125 | Status de espera de resolução | A reivindicação deve estar com status WAITING_RESOLUTION para executar a ação. |
| PIX-0126 | Deve ser o participante doador | A reivindicação deve ser do participante doador para confirmar. |
| PIX-0127 | Portabilidade não pode ser confirmada | Reivindicações de portabilidade não podem ser confirmadas com motivo DEFAULT_OPERATION. |
| PIX-0128 | Posse não pode ser confirmada | Reivindicações de posse não podem ser confirmadas com motivo DEFAULT_OPERATION antes do fim do período de resolução. |
Erros de reivindicação (cancelamento)
code | title | message |
|---|---|---|
| PIX-0134 | Reivindicação não pode ser cancelada | A reivindicação não pode ser cancelada no status atual. |
| PIX-0135 | Doador não pode cancelar reivindicação aberta | O participante doador não pode cancelar uma reivindicação com status OPEN. |
| PIX-0136 | Motivo inválido para o reivindicador | O reivindicador não pode cancelar com o motivo informado neste status. |
| PIX-0137 | Motivo inválido para o doador | O doador não pode cancelar com o motivo informado neste status. |
| PIX-0141 | Doador não pode cancelar portabilidade confirmada | O doador não pode cancelar uma reivindicação de portabilidade confirmada. |
| PIX-0142 | Período de resolução não encerrado | O período de resolução ainda não terminou para cancelamento com DEFAULT_OPERATION. |
| PIX-0143 | Período de cancelamento de posse não encerrado | Reivindicações de posse com DEFAULT_OPERATION podem ser canceladas apenas após CompletionPeriodEnd + 16 dias. |
| PIX-0144 | Prazo de cancelamento do doador expirado | O doador pode cancelar com FRAUD apenas enquanto o CompletionPeriodEnd não tiver passado. |
| PIX-0145 | Ator desconhecido | O participante não é nem o reivindicador nem o doador. |
Erros de reivindicação (conclusão)
code | title | message |
|---|---|---|
| PIX-0146 | Reivindicação não confirmada | A reivindicação deve estar com status CONFIRMED. |
| PIX-0147 | Deve ser o participante reivindicador | Somente o participante reivindicador pode concluir uma reivindicação. |
| PIX-0148 | Período de conclusão de posse não encerrado | Reivindicações de posse podem ser concluídas apenas após o fim do período de conclusão. |
| PIX-0149 | Reivindicação não pode ser reconhecida | A reivindicação não atende às pré-condições de reconhecimento (deve estar com status OPEN e quem chama deve ser o participante doador). |
| PIX-0160 | Reivindicação já concluída | A reivindicação já foi concluída. |
| PIX-0161 | Reivindicação está cancelada | A reivindicação foi cancelada e não pode ser concluída. |
| PIX-0162 | Reivindicação não pode ser concluída | A reivindicação não pode ser concluída no status atual. |
| PIX-0163 | Período de conclusão não definido | O período de conclusão não está definido para esta reivindicação. |
| PIX-0164 | Prazo de conclusão expirado | O período de conclusão expirou para esta reivindicação. |
Erros de VSync / CID
code | title | message |
|---|---|---|
| PIX-0150 | Arquivo CID não encontrado | O arquivo CID especificado não foi encontrado ou não está pronto para download. |
| PIX-0151 | Formato de CID inválido | O CID deve ser uma string hexadecimal minúscula de 64 caracteres. |
| PIX-0152 | CID não encontrado | O CID especificado não foi encontrado no DICT. |
Erros de MED (relatos de infração)
code | title | message |
|---|---|---|
| PIX-0200 | Relato de infração não encontrado | O relato de infração não foi encontrado. |
| PIX-0201 | Detalhes do relato muito longos | Os detalhes do relato excedem o tamanho máximo permitido de 2000 caracteres. |
| PIX-0202 | Formato de e-mail inválido | O formato do e-mail é inválido. |
| PIX-0203 | Formato de telefone inválido | O formato do telefone é inválido. |
| PIX-0204 | Relato de infração duplicado | Já existe um relato de infração para esta transação. |
| PIX-0205 | Formato de ID de transação inválido | O formato do ID da transação deve corresponder ao formato de um ID E2E. |
| PIX-0206 | Relato de infração não pode ser cancelado | O relato de infração não pode ser cancelado no status atual. |
| PIX-0207 | Relato de infração não pode ser encerrado | O relato de infração não pode ser encerrado no status atual. |
| PIX-0208 | Tipo de fraude obrigatório | O tipo de fraude é obrigatório quando o resultado da análise é AGREED. |
| PIX-0209 | Detalhes da análise obrigatórios | Os detalhes da análise são obrigatórios quando o tipo de fraude é OTHER. |
| PIX-0210 | Detalhes da análise muito longos | Os detalhes da análise excedem o tamanho máximo permitido de 2000 caracteres. |
| PIX-0211 | Transação não encontrada | A transação especificada não foi encontrada. |
| PIX-0212 | Transação muito antiga | A transação ocorreu há mais de 80 dias e não pode ser relatada. |
| PIX-0213 | Não autorizado a abrir solicitação de devolução | Um relato de infração de solicitação de devolução pode ser aberto apenas pelo PSP do pagador. |
| PIX-0214 | Não autorizado a abrir relato de cancelamento | Um relato de infração de cancelamento de devolução pode ser aberto apenas pelo PSP do recebedor. |
| PIX-0215 | Tipo de transação inválido | A transação não é uma transação de devolução. O cancelamento de infrações de devolução pode ser usado apenas para transações de devolução (pacs.004). |
| PIX-0216 | Não autorizado a encerrar solicitação de devolução | Um relato de infração de solicitação de devolução deve ser encerrado pelo PSP do recebedor. |
| PIX-0217 | Não autorizado a encerrar relato de cancelamento | Um relato de infração de cancelamento de devolução deve ser encerrado pelo PSP do pagador. |
| PIX-0218 | Motivo de cancelamento muito longo | O motivo do cancelamento excede o tamanho máximo permitido de 500 caracteres. |
| PIX-0219 | Formato de ID inválido | O ID deve estar em um formato UUID válido. |
| PIX-0220 | Ordem de intervalo de datas inválida | O timestamp modified_before deve ser posterior ao timestamp modified_after. |
| PIX-0221 | Transação de devolução muito antiga | A transação de devolução ocorreu há mais de 30 dias e não pode ser relatada para cancelamento. |
| PIX-0222 | Tipo de situação inválido | Relatos de infração de cancelamento de devolução devem usar situationType OTHER. |
| PIX-0223 | Relato de infração não pode ser reconhecido | O relato de infração não pode ser reconhecido no status atual. |
Erros de MED (solicitações de devolução)
code | title | message |
|---|---|---|
| PIX-0230 | Formato de valor de devolução inválido | O valor da devolução deve estar em formato decimal com exatamente 2 casas decimais (por exemplo, 100.50). |
| PIX-0231 | Detalhes da devolução muito longos | Os detalhes da devolução excedem o tamanho máximo permitido de 2000 caracteres. |
| PIX-0232 | Valor da devolução excede a transação | O valor da devolução não pode exceder o valor da transação original. |
| PIX-0233 | Detalhes da devolução ausentes | O campo refundDetails é obrigatório quando refundReason é OPERATIONAL_FLAW. |
| PIX-0234 | Solicitação de devolução não encontrada | A solicitação de devolução especificada não foi encontrada. |
| PIX-0235 | ID da transação de devolução ausente | O ID da transação de devolução é obrigatório quando a devolução é aceita (TOTALLY_ACCEPTED ou PARTIALLY_ACCEPTED). |
| PIX-0236 | Status da solicitação inválido | A solicitação não pode ser encerrada porque já está com status CLOSED ou CANCELLED. |
| PIX-0237 | Motivo de rejeição ausente | O refundRejectionReason é obrigatório quando analysisResult é REJECTED. |
| PIX-0238 | Detalhes da análise ausentes | O campo analysisDetails é obrigatório quando analysisResult é REJECTED e refundRejectionReason é INVALID_REQUEST. |
| PIX-0239 | Não é possível cancelar a solicitação | A solicitação não pode ser cancelada porque já está com status CLOSED ou CANCELLED. |
| PIX-0240 | Relato de infração ausente | Uma solicitação de devolução com motivo FRAUD exige um relato de infração anterior que tenha sido encerrado com resultado AGREED. |
| PIX-0241 | Relato de infração expirado | O relato de infração foi encerrado há mais de 72 horas. Solicitações de devolução devem ser criadas em até 72 horas após o encerramento do relato de infração. |
| PIX-0242 | Solicitação de devolução duplicada | Já existe uma solicitação de devolução para esta transação. |
| PIX-0243 | Solicitação de devolução já encerrada | A solicitação de devolução já está encerrada. |
| PIX-0244 | Solicitação de devolução já cancelada | A solicitação de devolução já está cancelada. |
| PIX-0245 | Intervalo de datas excede 90 dias | O intervalo de datas entre modifiedAfter e modifiedBefore não pode exceder 90 dias. |
Erros de MED (marcadores de fraude)
code | title | message |
|---|---|---|
| PIX-0260 | Formato de CPF/CNPJ inválido | O taxIdNumber deve estar em um formato válido de CPF (11 dígitos) ou CNPJ (14 dígitos). |
| PIX-0261 | Formato de chave inválido | A chave deve ter entre 8 e 32 caracteres. |
| PIX-0262 | Marcador de fraude não encontrado | O marcador de fraude especificado não foi encontrado. |
| PIX-0263 | Não é possível cancelar o marcador | O marcador de fraude não pode ser cancelado porque já está com status CANCELLED. |
Erros de MED (estatísticas)
code | title | message |
|---|---|---|
| PIX-0280 | Valor de chave inválido | O valor da chave é inválido ou excede o tamanho máximo de 77 caracteres. |
Erros de QR Code
code | title | message |
|---|---|---|
| PIX-0300 | Formato EMV inválido | O payload EMV não segue a especificação de formato EMV QCO válida. |
| PIX-0301 | QR Code corrompido | Os dados do QR Code estão corrompidos e não podem ser decodificados. |
| PIX-0302 | Versão de QR Code não suportada | A versão ou o formato do QR Code não é suportado. |
| PIX-0303 | Data de pagamento inválida | A data de pagamento excede o período de pagamento válido. |
| PIX-0304 | Valor inválido | O valor deve ser maior que zero e seguir o formato 0.00, com duas casas decimais. |
| PIX-0305 | Cidade inválida | A cidade deve conter apenas letras e espaços. |
| PIX-0306 | Formato de TxID inválido | O formato do txId é inválido. |
| PIX-0307 | Chave do recebedor obrigatória | O receiverKey é obrigatório. |
| PIX-0309 | Formato de código de categoria inválido | O categoryCode deve ser numérico. |
| PIX-0310 | Nome do lojista inválido | O nome do lojista é obrigatório. |
| PIX-0311 | Chave do recebedor não encontrada | O receiverKey não foi encontrado. |
| PIX-0312 | Chave do recebedor inválida | O receiverKey é inválido. |
| PIX-0314 | EMV obrigatório | O EMV é obrigatório. |
| PIX-0315 | Payload EMV vazio | O payload EMV não pode estar vazio. |
| PIX-0316 | EMV não encontrado | O QR Code EMV não foi encontrado. |
| PIX-0317 | Código da cidade inválido | O código da cidade é inválido. |
| PIX-0318 | BR Code não encontrado | O BR Code solicitado não foi encontrado. |
| PIX-0319 | Chave do recebedor não associada | A chave do recebedor não está associada à conta. |
| PIX-0320 | Nome do lojista inválido | O nome do lojista é obrigatório. |
| PIX-0321 | Cidade do lojista inválida | A cidade do lojista deve conter apenas letras e espaços. |
| PIX-0322 | Código de categoria do lojista inválido | O código de categoria do lojista deve ser numérico. |
| PIX-0324 | Valor inválido | O valor não é um decimal válido. |
| PIX-0327 | ID de requisição do cliente inválido | O ID de requisição do cliente deve ser um UUID válido. |
| PIX-0328 | Tipo de imagem inválido | O tipo de imagem deve ser um dos seguintes: Gif, Jpeg, Png. |
| PIX-0329 | Pixels por módulo inválido | O valor de pixels por módulo está fora dos limites. |
| PIX-0330 | Serviço indisponível | O serviço de decodificação está temporariamente indisponível. |
Erros de transferências
code | title | message |
|---|---|---|
| PIX-0400 | Descrição muito longa | O campo de descrição excede o tamanho máximo permitido de 140 caracteres. |
| PIX-0401 | Descrição contém HTML | A descrição contém caracteres HTML inválidos. |
| PIX-0402 | Formato de valor inválido | O valor deve estar no formato 0.00, com exatamente 2 casas decimais (de 1 a 10 dígitos antes do ponto decimal). |
| PIX-0403 | Valor deve ser positivo | O valor deve ser maior que zero. |
| PIX-0404 | Formato de UUID inválido | O formato do UUID é inválido. |
| PIX-0405 | Formato de ID end-to-end inválido | O formato do ID end-to-end é inválido. |
| PIX-0406 | Transferência intra-PSP não suportada | Transferências INTRA PSP (mesmo participante) não são suportadas. O ISPB do banco de destino não pode ser igual ao do PSP de origem. |
| PIX-0407 | Conta da transferência não corresponde | A transferência não pertence à conta especificada. |
Erros de iniciação
code | title | message |
|---|---|---|
| PIX-0410 | Iniciação não encontrada | A iniciação de pagamento não foi encontrada. |
| PIX-0411 | Iniciação expirada | A iniciação de pagamento expirou. |
| PIX-0412 | Iniciação já utilizada | A iniciação de pagamento já foi processada. |
| PIX-0413 | Estado inválido da iniciação | A iniciação de pagamento está em um estado inválido. |
| PIX-0414 | Destino obrigatório | O destino é obrigatório para o tipo de iniciação MANUAL. |
| PIX-0415 | Tipo de iniciação inválido | O tipo de iniciação é inválido. |
| PIX-0416 | Chave obrigatória | A chave é obrigatória para o tipo de iniciação KEY. |
| PIX-0417 | EMV obrigatório | O EMV é obrigatório para o tipo de iniciação QR_CODE. |
| PIX-0418 | Destino inválido | O destino é inválido para o tipo de iniciação MANUAL. |
Erros de cash-out
code | title | message |
|---|---|---|
| PIX-0420 | Cash-out não encontrado | A transação de cash-out não foi encontrada. |
| PIX-0421 | Saldo insuficiente | Saldo insuficiente para completar a transação. |
| PIX-0422 | Valor não corresponde | O valor não corresponde ao valor fixo do QR Code. |
| PIX-0423 | ID end-to-end duplicado | Já existe uma transação com este ID end-to-end. |
| PIX-0424 | Valor inválido | O valor deve ser maior que zero. |
| PIX-0425 | Cash-in não encontrado | A transação de cash-in não foi encontrada. |
| PIX-0426 | Transferência não encontrada | A transferência não foi encontrada. |
| PIX-0427 | Devolução não encontrada | A devolução não foi encontrada. |
| PIX-0428 | Devolução duplicada | Já existe uma devolução para esta transação. |
Erros de conta
code | title | message |
|---|---|---|
| PIX-0430 | Conta não encontrada | A conta não foi encontrada no ledger. |
| PIX-0431 | Conta bloqueada | A conta está bloqueada e não pode realizar transações. |
Erros de devolução
code | title | message |
|---|---|---|
| PIX-0440 | Transferência original não é cash-in | Somente transferências de cash-in podem ser devolvidas com devoluções de cash-out. |
| PIX-0441 | Transferência original não concluída | Somente transações concluídas podem ser devolvidas. |
| PIX-0442 | Devolução excede o valor original | O valor da devolução excede o valor da transação original. |
| PIX-0443 | Motivo de devolução inválido | O código do motivo da devolução é inválido. |
| PIX-0444 | Devolução excede o valor líquido | O valor da devolução parcial excede o valor líquido disponível após as tarifas. |
| PIX-0445 | Status da transação inválido | Somente transações concluídas podem ser devolvidas. |
Erros de validação de destino
code | title | message |
|---|---|---|
| PIX-0450 | Banco de destino obrigatório | O banco de destino é obrigatório. |
| PIX-0451 | Banco de destino inválido | O banco de destino deve ter 8 dígitos. |
| PIX-0452 | Agência de destino obrigatória | A agência de destino é obrigatória. |
| PIX-0453 | Conta de destino obrigatória | A conta de destino é obrigatória. |
| PIX-0454 | Tipo de conta de destino inválido | O tipo de conta de destino é inválido. |
| PIX-0455 | Documento de destino obrigatório | O documento de destino é obrigatório. |
| PIX-0456 | Documento de destino inválido | O documento de destino é inválido: deve ser CPF (11 dígitos) ou CNPJ (14 dígitos). |
| PIX-0457 | Nome de destino obrigatório | O nome de destino é obrigatório. |
| PIX-0458 | Tipo de pessoa de destino inválido | O tipo de pessoa de destino é inválido. |
| PIX-0459 | Tipo de pessoa de destino não corresponde | O tipo de pessoa não corresponde ao documento: CPF exige NATURAL_PERSON, CNPJ exige LEGAL_PERSON. |
Erros de transição de status
code | title | message |
|---|---|---|
| PIX-0470 | Transição de status inválida | A transição de status é inválida. |
| PIX-0471 | Transferência já em estado terminal | A transação já está em um estado terminal. |
| PIX-0472 | Não é possível cancelar | Não é possível cancelar a transação no status atual. |
| PIX-0473 | Já em estado terminal | A operação já está em um estado terminal. |
Erros de integração (CRM)
code | title | message |
|---|---|---|
| PIX-0500 | Erro de conexão com o CRM | Falha ao conectar ao serviço de CRM. |
| PIX-0501 | Erro de autenticação com o CRM | Falha ao autenticar com o serviço de CRM. |
| PIX-0502 | Conta não encontrada no CRM | A conta não foi encontrada no CRM para os critérios informados. |
| PIX-0503 | Titular não encontrado no CRM | O titular não foi encontrado no CRM. |
| PIX-0504 | Agência inválida no CRM | A agência retornada pelo CRM é inválida. Esperados exatamente 4 dígitos. |
| PIX-0505 | Número de conta inválido no CRM | O número de conta retornado pelo CRM é inválido. Esperados de 1 a 20 dígitos. |
| PIX-0506 | Documento inválido no CRM | O documento (CPF/CNPJ) retornado pelo CRM é inválido. |
| PIX-0507 | Nome inválido no CRM | O nome retornado pelo CRM é inválido ou excede 120 caracteres. |
| PIX-0508 | Nome fantasia inválido no CRM | O nome fantasia retornado pelo CRM é inválido ou excede 100 caracteres. |
| PIX-0509 | Data de abertura inválida no CRM | A data de abertura retornada pelo CRM é inválida. Formato esperado: yyyy-mm-dd. |
| PIX-0510 | Tipo de conta inválido no CRM | O tipo de conta retornado pelo CRM é inválido. Esperado: CACC, SLRY, SVGS, TRAN ou OTHR. |
| PIX-0599 | Requisição inválida ao CRM | O CRM retornou um erro de requisição inválida. |
Erros de integração (Midaz)
code | title | message |
|---|---|---|
| PIX-0600 | Saldo insuficiente no Midaz | Saldo insuficiente na conta de origem. |
| PIX-0601 | Conta bloqueada no Midaz | A conta está bloqueada e não pode realizar transações. |
| PIX-0602 | Erro de conexão com o Midaz | Falha ao conectar ao Midaz. |
Erros de integração (Fee Service)
code | title | message |
|---|---|---|
| PIX-0650 | Erro de conexão com o Fee Service | Falha ao conectar ao Fee Service. |
Erros de cobrança
code | title | message |
|---|---|---|
| PIX-0700 | Cobrança não encontrada | A cobrança não foi encontrada. |
| PIX-0701 | TxID de cobrança duplicado | Já existe uma cobrança com este txId para o recebedor. |
| PIX-0702 | Cobrança já excluída | A cobrança já foi excluída. |
| PIX-0703 | Tipo de cobrança inválido | O tipo de cobrança é inválido. |
| PIX-0704 | Status de cobrança inválido | O status da cobrança é inválido ou não permite esta operação. |
| PIX-0705 | Valor de cobrança inválido | O valor da cobrança é inválido. |
| PIX-0706 | Expiração da cobrança inválida / Chave do recebedor não pertence à conta | A expiração da cobrança é inválida / A chave do recebedor não está associada à conta. |
| PIX-0707 | Data de vencimento inválida / Devedor inválido | A data de vencimento é inválida / As informações do devedor são inválidas. |
| PIX-0708 | Expiração muito longa / Cobrança sem ID de provedor | A expiração excede o máximo permitido: 30 dias (2.592.000 segundos) / A cobrança não tem ID pactual. |
| PIX-0709 | TxID inválido / Motivo de exclusão inválido | 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 | Documento do recebedor inválido | O documento do recebedor é inválido ou não pode estar vazio. |
| PIX-0711 | Nome do recebedor inválido | O nome do recebedor é inválido ou não pode estar vazio. |
| PIX-0712 | Endereço do recebedor inválido | O endereço do recebedor é obrigatório. |
| PIX-0713 | Nome do devedor inválido | O nome do devedor é inválido ou não pode estar vazio. |
| PIX-0714 | Formato de CPF inválido | O formato do CPF é inválido: deve ter exatamente 11 dígitos. |
| PIX-0715 | Formato de CNPJ inválido | O formato do CNPJ é inválido: deve ter exatamente 14 dígitos. |
| PIX-0716 | ID de conta inválido | O ID da conta é inválido ou não pode estar vazio. |
| PIX-0717 | ID pactual inválido | O ID pactual é inválido ou não pode estar vazio. |
| PIX-0718 | ID de localização inválido | O ID de localização é inválido ou não pode estar vazio. |
| PIX-0719 | Multa inválida | A configuração da multa está incompleta: tipo e valor devem ser informados. |
| PIX-0720 | Juros inválidos | A configuração dos juros está incompleta: tipo e valor devem ser informados. |
| PIX-0721 | Desconto inválido | A configuração do desconto está incompleta: tipo, valor e dias antes do vencimento devem ser informados. |
| PIX-0722 | Abatimento inválido | A configuração do abatimento está incompleta: tipo e valor devem ser informados. |
| PIX-0723 | Excesso de informações adicionais | O número de itens de informações adicionais excede o máximo permitido: 50. |
| PIX-0724 | Valor do Pix Troco não corresponde | O valor da transação de Pix Troco deve ser igual ao valor original. |
| PIX-0725 | Configuração de Pix Saque inválida | O Pix Saque não pode ter valor de transação, apenas valor de saque. |
| PIX-0726 | Atualização de cobrança não permitida | Atualizações não são permitidas para esta cobrança. |
| PIX-0727 | Documento do devedor não corresponde | O documento do devedor do pagamento não corresponde ao devedor da cobrança. |
| PIX-0728 | Tipo não corresponde | O tipo do pagamento não corresponde ao tipo da cobrança. |
| PIX-0729 | Valor da cobrança não corresponde | O valor do pagamento não corresponde ao valor da cobrança. |
Erros do provedor (BTG)
code | title | message |
|---|---|---|
| PIX-1000 | Erro de conexão com o provedor | Falha ao conectar ao provedor. |
| PIX-1001 | Erro de autenticação com o provedor | Falha ao autenticar com o provedor. |
| PIX-1002 | Tempo limite da requisição ao provedor | A requisição ao provedor atingiu o tempo limite. |
| PIX-1003 | Limite de taxa excedido | Limite de taxa excedido. Tente novamente mais tarde. |
| PIX-1004 | Serviço do provedor indisponível | O serviço do provedor está temporariamente indisponível. |
| PIX-1005 | Chave não encontrada | A chave Pix não foi encontrada. |
| PIX-1006 | Chave já existe | A chave Pix já existe. |
| PIX-1007 | Erro interno do provedor | O provedor retornou um erro interno. |
| PIX-1008 | Resposta inválida do provedor | O provedor retornou uma resposta inválida. |
| PIX-1009 | Requisição inválida ao provedor | O provedor rejeitou a requisição devido a dados inválidos. |
| PIX-1010 | Provedor não conseguiu processar | O provedor não pode processar a requisição. |
| PIX-1099 | Erro não mapeado do provedor | O provedor retornou um erro não mapeado. |
Erros do provedor (MED)
code | title | message |
|---|---|---|
| PIX-1065 | Solicitação de devolução duplicada | O provedor informa que já existe uma solicitação de devolução para esta transação. |
| PIX-1068 | Status da solicitação inválido | O provedor informa que a solicitação está em um estado inválido para esta operação. |
| PIX-1069 | Não é possível cancelar a solicitação | O provedor informa que a solicitação não pode ser cancelada devido ao seu estado atual. |
| PIX-1080 | Marcador de fraude duplicado | O provedor informa que já existe um marcador de fraude para esta combinação de documento e chave. |
| PIX-1081 | Tipo de fraude inválido | O provedor informa que o tipo de fraude não é válido para esta operação. |
| PIX-1083 | Não é possível cancelar o marcador | O provedor informa que o marcador não pode ser cancelado devido ao seu estado atual. |
| PIX-1090 | Estatísticas da pessoa não encontradas | O provedor informa que nenhuma estatística foi encontrada para o documento fiscal especificado. |
| PIX-1091 | Estatísticas da chave não encontradas | O provedor informa que nenhuma estatística foi encontrada para a chave Pix especificada. |