Transferência Pix
A transferência Pix envia dinheiro da conta financeira de origem para outra conta, identificada por uma chave Pix ou pelos dados bancários do destino (banco, agência e conta).
Onde fica no painel
- Abra Financeiro > Transferências > Nova Transferência (ou Cadastrar > Transferência).
- A tela "Selecione a conta de transferência para iniciar a transferência" lista as contas de transferência com Banco, Conta Financeira, Saldo e Integrações. Use a busca para filtrar por nome, número ou agência da conta.
- Na linha da conta de origem, clique no ícone Transferência Pix.
O formulário abre com o título Nova Transferência Pix, seguido do nome da conta financeira, do número da conta de transferência e, quando houver, do convênio.
Campos
| Campo | Obrigatório | Descrição |
|---|---|---|
| Tipo do Pix | Sim | Chave ou Dados bancários. Define quais campos de destino aparecem. |
| Quantia | Sim | Valor em reais. Precisa ser maior que zero. |
| Agendado para | Sim | Data da transferência. O calendário começa em hoje; datas passadas são recusadas. |
| Objetivo da Transferência | Não | Aparece só com Dados bancários. Lista de finalidades com código, como "20 - Pagamento Fornecedor". O padrão é "98 - Pagamentos Diversos". |
| CPF/CNPJ do Beneficiário | Sim | Documento de quem recebe. |
| Nome do Beneficiário | Sim | Até 99 caracteres. Ao digitar um CNPJ, o painel consulta a razão social e preenche este campo se ele estiver vazio. |
| Identificador | Não | Texto de identificação do pagamento no comprovante do banco. Só alguns bancos usam este campo. |
Com Tipo do Pix = Chave
| Campo | Obrigatório | Descrição |
|---|---|---|
| Tipo da Chave Pix | Sim | CPF, CNPJ, Aleatória, E-mail ou Celular. |
| Chave Pix | Sim | A chave do destino. |
A Kobana confere o formato da chave antes de salvar e recusa a transferência quando a chave não combina com o tipo:
| Tipo da chave | Erro quando o formato não confere |
|---|---|
| CPF | não é um CPF válido |
| CNPJ | não é um CNPJ válido |
| não é um e-mail válido | |
| Celular | telefone inválido |
| Aleatória | não é uma chave aleatória válida |
A conferência é só de formato: ela não consulta se a chave existe no Pix.
Com Tipo do Pix = Dados bancários
| Campo | Obrigatório | Descrição |
|---|---|---|
| Banco | Sim | Banco de destino, escolhido na lista. |
| Número da Agência | Sim | Até 6 dígitos, só números. |
| Dígito da Agência | Depende do banco | Exigido para bancos que usam dígito de agência. |
| Número da Conta | Sim | Até 10 dígitos, só números. |
| Dígito da Conta | Sim | 1 caractere: número ou X. |
Passo a passo
- Abra o formulário pela tela Nova Transferência, como descrito acima.
- Escolha o Tipo do Pix e preencha os campos que aparecem.
- Clique em Salvar transferência.
Com os dados válidos, o painel volta para a lista de transferências com a mensagem "Transferência criada com sucesso.". Se algum campo estiver errado, o formulário reaparece com "Não foi possível criar a transferência. Por favor, verifique os erros abaixo.".
Cancelar e Voltar sai do formulário sem salvar.
O que acontece depois
A transferência é criada com a situação Pendente e a situação do registro Pendente. O envio ao banco é feito em segundo plano pela Kobana e o resultado aparece na lista e no detalhe da transferência. Veja Acompanhamento, edição e cancelamento.
O envio ao banco logo após a criação depende de uma regra de automação da sua conta, habilitada pela equipe da Kobana. Sem essa regra, a transferência fica Pendente e não é enviada. Se suas transferências não saem dessa situação, fale com o suporte.
Se a conta de transferência estiver com Validação de Saldo Habilitada e o valor passar do saldo da conta financeira, a transferência não é criada e o formulário mostra "Saldo insuficiente". Veja Contas de transferência.
Permissões
Módulo Pagamento, produto Transferências, ação Criar.
Pela API
Transferências Pix podem ser criadas, consultadas, canceladas, aprovadas e reagendadas pela API v2.