Códigos de Erro

Abaixo seguem os códigos de erro de referência para diversos domínios de integração do Pinbank.

As mensagens abaixo são explicativas, para facilitar o entendimento humano do erro. Elas não refletem necessariamente o texto literal retornado pelo sistema. Para lógica de integração (tratamento condicional, retries, etc.), utilize sempre o código, não o texto da mensagem.

Conta Digital (Gestão de Contas)

Domínio	Evento	Descrição
Conta Digital	ContaDigital.CadastroPf	Resultado do cadastro de pessoa física/jurídica — cobre sucesso e erro.
Conta Digital	ContaDigital.ValidacaoCliente	Resultado da validação de disponibilidade de um dado (CPF, e-mail, celular) — dispara em toda tentativa, sucesso ou falha.
Conta Digital	ContaDigital.AlteracaoStatus	Status da conta foi alterado.

Código	Mensagem (pt-BR)
1	Sem resultado.
2	Erro de Sistema.
3	Erro de validação.
4	Tamanho do Apelido inválido.
5	Apelido já cadastrado.
5	Usuário ou Senha inválido.
6	Usuário bloqueado.
10	Atualizar ramo de atividade.
13	Número de celular inválido.
17	Email inválido.
18	Senha muito fraca.
19	Código de verificação expirado.
20	Arquivo inválido.
21	Documento já cadastrado.
23	Documento não encontrado.
24	Este documento não pode ser alterado.
27	Erro ao buscar dados do CEP.
28	Número de celular inválido.
29	Erro ao enviar SMS.
33	Documentação da conta do cliente não aprovada.
40	Data de nascimento inválida.
41	Número de celular não informado.
41	CPF / CNPJ inválido.
42	Número de Celular inválido.
43	Erro ao consultar serviço de verificação de documentos.
52	Termo não encontrado
53	O tipo não é um arquivo
54	Celular, ddd e ddi é obrigatório para envio do Token
55	Email e obrigatório para envio do Token
58	Conta não aprovada.
62	Conta inexistente, favor verificar dado informado.
64	Não localizamos a documentação em seu cadastro. Envie os documentos pendentes pelo canal digital, na área de dados cadastrais.
65	Existem documentos não aprovados em seu cadastro. Remova o documento reprovado e envie um novo pelo canal digital, na área de dados cadastrais.
66	Sua documentação está em análise. O resultado será enviado por e-mail.
84	IdentificadorFace não encontrado.
85	Não foi possível concluir o cadastro. Dados incompletos.
86	O serviço de verificação facial está temporariamente indisponível. Tente novamente mais tarde.
87	Não foi possível validar seu rosto no momento. Tente novamente mais tarde.
88	Perfil não aprovado.
89	Nome inválido.
422	Documento com restrição de cadastro no BCProtege+

PIX

Domínio	Evento	Descrição
Pix	Pix.CreditoRecebido	Um Pix foi recebido e confirmado na conta digital de um cliente.
Pix	Pix.TransferenciaRealizada	Resultado do processamento de uma transferência Pix enviada por um cliente — cobre sucesso e falha.
Pix	Pix.DevolucaoEnviada	Confirmação do Bacen sobre uma devolução Pix enviada por um cliente (cliente = pagador da devolução).
Pix	Pix.DevolucaoRecebida	Devolução Pix processada e creditada na conta de um cliente (cliente = recebedor da devolução).

QR Code

Código	Mensagem (pt-BR)
1	Erro de Sistema.
2	Erro de validação.
4	Usuário bloqueado.
5	Usuário não encontrado.
6	CodigoCanal não encontrado.
7	Documentação da conta do cliente não aprovada.
8	Sem resultado.

Pagamento

Código	Mensagem (pt-BR)
1	Código Cliente null ou vazio.
1	Erro de Sistema.
2	Código Canal null ou vazio.
2	Erro de validação.
3	Apelido não informado.
4	Usuário bloqueado.
4	Tamanho do Apelido inválido.
5	Código do banco não informado.
5	Usuário não encontrado.
6	CodigoCanal não encontrado.
6	Código do banco inválido.
7	Documentação da conta do cliente não aprovada.
7	Agência não informada.
8	Sem resultado.
8	Agência inválida.
9	O dígito da agência é requerido para o banco selecionado.
9	Pix QrCode pendente.
10	Dígito da agência inválido.
10	Pix QrCode erro.
11	Conta Corrente não informado.
11	Pinbank QrCode id não encontrado.
12	Dígito da conta corrente não informado.
12	NsuOrigem não informado.
13	Dígito da conta corrente inválido.
13	QrCode cancelado timeout.
14	Tipo da Conta não informado.
14	Erro ao buscar informações do QrCode.
15	Autorização negada.
15	Tipo Pessoa não informado.
16	Nome do Favorecido não informado.
16	Limite máximo não definido.
17	CPF / CNPJ do favorecido não informado.
17	Nenhuma chave ativa encontrada. Por favor cadastre uma chave para realizar esta operação.
18	Código do banco inválido.
18	CPF / CNPJ do favorecido inválido.
19	CPF / CNPJ do favorecido inválido para o Tipo Pessoa informado.
19	Operação cancelada TimeOut.
20	Apelido já cadastrado.
20	URL de webhook não cadastrada. Favor contactar seu agente comercial.
21	Favorecido já cadastrado.
21	Operação não permitida. Por favor, realize o login novamente.
22	Lista de favorecidos não informada.
22	Propriedade Token null ou vazio.
23	Favorecido inválido
23	Token inválido.
24	Operação pendente.
25	Valor do PIX não informado
26	O agendamento máximo permitido é de até 12 meses.
27	Limites pix em analise, por favor aguarde.
28	Para pix agendados só é permitida a aprovação até as [hour]h
29	Status do Pix inválido ou não reconhecido.
30	Não é permitido solicitar agendamentos para o dia seguinte após as 23:30h.
31	Retorno de PIX não permitido
32	Identificador de referência não encontrado
33	Valor devolução PIX não disponível
34	Chave pix do destinatário não localizada.
35	Data limite para devolução Pix finalizada
36	Valor não permitido para devolução.
37	A sua conta ainda não tem chave pix cadastrastrada. Cadastre sua chave antes.
38	Devolução não permitida para Pix origem Boleto.
39	Você ainda não tem nenhum contato favorito cadastrado.
40	Horário noturno Pix inicial inválido.
41	Horário noturno Pix já configurado.
42	Já existe uma solicitação de alteração do horário noturno em andamento.
43	Não existe nenhuma solicitação de alteração de horário noturno no momento.
44	Limite pix diurno em analise, por favor aguarde.
45	Limite pix noturno em analise, por favor aguarde.
46	Limite pix domingos e feriados em analise, por favor aguarde.
47	Pagamento duplicado identificado em curto intervalo de tempo. Aguarde antes de tentar novamente.
48	Devolução não permitida
49	Operacao não permitida para outra titularidade.
50	Transação de dupla aprovação não encontrada.
51	Operação de dupla aprovação inválida.
52	Horario de limite inválido.
53	Horário máximo para esta operação ultrapassado.
54	Categoria Limite Pix não encontrada
55	Tarifas limites PIX não encontrada
56	END2END não encontrado
57	Chave PIX inválida
58	Texto Qrcode não permitido para o tipo de pagamento do agendamento
59	Dados bancarios não permitido para o tipo de pagamento do agendamento
60	Chave não permitida para o tipo de pagamento do agendamento
70	Erro ao buscar chave pix.
77	Autorização negada. Verifique o saldo disponível.
78	MiniEc não permitido.
79	CPF / CNPJ inválido.
80	Key Owner Name é obrigatório.
81	Descrição da Recorrencia não informada.
82	Quantidade de Parcelas da Recorrencia não informada.
83	Periodicidade da Recorrencia não informada.
84	key Owner CpfCnpj inválido.
85	Data da primeira parcela inválida. Deve ser informada uma data futura válida para a primeira parcela.
86	É permitido até 30 repetições de agendamento recorrente.
87	Ocorreu um erro ao gerar o Pix Automático.
1001	Sua solicitação foi recebida e aguarda aprovação Master

Pix Automático

Código	Mensagem (pt-BR)
23	PisoValorMaximo cannot be filled in fixed value authorizations.
24	Se o devedor for igual ao pagador, os campos do devedor não devem ser preenchidos.
25	Recorrência não encontrada.
26	A data de vencimento deve ter no mínimo 2 dias de antecedência em relação à data atual.
27	Período indisponível: já há um agendamento cadastrado.
28	Como a recorrência foi criada com valor fixo, não é permitido informar valores individuais nos agendamentos.
29	Agendamento já cancelado, pago ou inativo.
30	O identificador do consentimento (RecurringConsentId) é inválido. Deve ser um URN válido (RFC8141).

Consulta de Chave

Código	Mensagem (pt-BR)
0	Sucesso.
1	Erro de Sistema.
2	Erro de validação.
3	Bad request.
4	Usuário bloqueado.
5	Usuário não encontrado.
6	CodigoCanal não encontrado.
7	Documentação da conta do cliente não aprovada.
8	Sem resultado.
9	Agência ou número de conta não encontrado.
10	Erro ao enviar SMS.
11	Código Cliente null ou vazio.
12	Código Canal null ou vazio.
13	CPF / CNPJ não informado.
14	Esta chave já está cadastrada em sua conta.
15	Registro da chave Pix negado.
16	Identificador de pagamento não encontrado no agente emissor ou data de pesquisa inválida. Verifique a data no comprovante de pagamento.
17	Não foi possível localizar um ID de QrCode para este End-to-end (NuOp)
18	Tipo de chave não permitido.
19	Termo não encontrado
20	Chave PIX enviada não consta no cadastro
21	Já existe vínculo para essa chave mas ela é possuída por outra pessoa. Indica-se que seja feita uma reivindicação de posse.
22	Já existe vínculo para essa chave com o mesmo dono, mas ela encontra-se associada a outro participante. Indica-se que seja feita uma reivindicação de portabilidade.
23	Chave em processo de Reivindicação.
24	Reivindicação não encontrada para essa chave.
25	Esta chave não está em processo de reivindicação.
26	Erro ao cancelar a reivindicação da chave.
27	Confirmação não permitida.
28	Erro ao solicitar a reivindicação
29	Operação não permitida: o prazo para cancelamento já expirou.
30	Este e-mail já está associado a outro CPF/CNPJ e não é permitida a reivindicação de posse de chave Pix do tipo e-mail.
31	Erro ao consultar dados do CPF em serviço externo.
32	Erro ao consultar dados do CNPJ em serviço externo.

Conta Digital (Gestão de Contas)#

PIX#

QR Code#

Pagamento#

Pix Automático#

Consulta de Chave#

Conta Digital (Gestão de Contas)

PIX

QR Code

Pagamento

Pix Automático

Consulta de Chave