Para que um pagamento Pix seja processado corretamente na Kamino, dois grupos de informações precisam estar em ordem: os dados do lançamento e o cadastro do beneficiário. Este artigo reúne tudo o que você precisa conferir antes de enviar.
Como a Kamino valida um pagamento Pix
Todo pagamento via Pix passa por uma validação automática de chave antes de ser enviado ao banco. A Kamino verifica se o CPF ou CNPJ cadastrado no perfil do beneficiário corresponde ao CPF ou CNPJ titular da chave Pix informada no pagamento.
Essa verificação acontece em dois momentos distintos:
CPF/CNPJ ausente no cadastro → o pagamento é bloqueado antes mesmo de chegar ao banco, com uma mensagem orientando a completar o cadastro da pessoa.
CPF/CNPJ divergente da titularidade da chave Pix → o pagamento não é processado e você recebe um aviso de divergência.
⚠️ Atenção: essa validação protege sua empresa contra pagamentos realizados para destinatários incorretos ou não identificados. Mantenha o cadastro dos beneficiários sempre atualizado.
O que precisa estar no cadastro do beneficiário
Antes de enviar qualquer pagamento Pix, confira se o beneficiário possui os seguintes dados preenchidos em Pessoas e Empresas:
Dados obrigatórios
CPF (pessoa física) ou CNPJ (pessoa jurídica) — obrigatório para a validação da chave Pix.
Chave Pix — pode ser CPF, CNPJ, e-mail, telefone ou chave aleatória. Deve estar vinculada ao mesmo CPF/CNPJ do cadastro.
Tipos de chave Pix aceitos
CPF ou CNPJ
E-mail
Telefone
Chave aleatória (EVP)
Agência e conta bancária — nesse caso, informe também banco, agência, número da conta e tipo de conta.
O que precisa estar no lançamento de pagamento
Além do cadastro do beneficiário, o lançamento em si exige os seguintes campos:
Campos obrigatórios para qualquer pagamento
Beneficiário (Pessoa) — vinculado ao cadastro com CPF/CNPJ preenchido.
Valor
Data de vencimento
Descrição
Classificação financeira
Centro de custo
Conta de pagamento — a conta que irá executar a transação.
Campos específicos para Pix
Caso seja para uma chave Pix: O Cadastro do Benefíciário (Pessoa) precisa ter uma chave Pix cadastrada.
Caso seja um Pix Copia e Cola ou QR code, cole o código ou importe o arquivo com o QR code.
O que acontece se algo estiver faltando
CPF/CNPJ ausente no cadastro
O pagamento é bloqueado e um alerta é exibido com a orientação: "Preencha o CPF/CNPJ do beneficiário do pagamento." O botão Editar pessoa abre diretamente o cadastro para correção. O status do pagamento permanece Pendente até ser reenviado.
Caso o pagamento já tenha sido enviado e bloqueado, no detalhe do pagamento o histórico registra automaticamente um evento.
CPF/CNPJ divergente da titularidade da chave
O documento cadastrado não corresponde ao titular da chave Pix informada. O pagamento não é processado e você recebe uma mensagem de divergência. Verifique se a chave Pix está correta e se o CPF/CNPJ cadastrado é o mesmo que consta no banco do beneficiário.
Como verificar e corrigir o cadastro
Acesse Menu lateral > Pessoas e Empresas.
Localize o beneficiário e clique em Editar.
Verifique se o campo CPF (pessoa física) ou CNPJ (pessoa jurídica) está preenchido corretamente.
Confirme se a Chave Pix cadastrada pertence ao mesmo CPF/CNPJ.
Salve e retorne ao pagamento para reenviar.
Dica: ao manter os cadastros sempre atualizados em Pessoas e Empresas, você evita bloqueios e garante agilidade no processo de pagamento — sem precisar corrigir na hora da execução.
Dúvidas frequentes
Posso usar uma chave Pix diferente da cadastrada no perfil da Pessoa?
Não, é sempre necessário editar o cadastro da Pessoa para alterar a chave Pix. Atenção: ao importar pagamentos via planilha com uma nova chave Pix, o cadastro da Pessoa será atualizado automaticamente com a nova informação.
A validação de chave Pix se aplica a todos os tipos de conta?
Sim. A verificação ocorre para pagamentos enviados pela conta Kamino, independentemente do tipo de chave informada.
O que é a chave aleatória (EVP)?
É uma sequência de caracteres gerada automaticamente pelo banco do beneficiário, sem vínculo com dados pessoais. Funciona como qualquer outra chave Pix — basta informá-la no cadastro da Pessoa e selecionar o tipo "Chave aleatória" no lançamento.
Posso alterar a chave Pix de um beneficiário?
Sim, desde que você possua a permissão de alterar dados bancários e de Pix habilitada no seu perfil. Sem essa permissão, os campos ficam bloqueados para edição.