Acompanhamento, edição e cancelamento
Depois de criada, a transferência passa por duas situações que andam juntas: a Situação do Registro, que diz se o banco já recebeu a transferência, e a Situação, que diz em que ponto do processamento ela está. Esta página mostra onde acompanhar essas situações e o que você pode fazer em cada uma.
Lista de transferências
Financeiro > Transferências > Gerenciar.
| Coluna | Conteúdo |
|---|---|
| UID | Identificador da transferência, com botão para copiar. |
| Situação | Dois ícones: o primeiro é o registro no banco, o segundo é a situação. Passe o mouse para ver o nome. |
| Tipo | Pix, TED ou Entre Contas, com os dados do destino. |
| Conta de Transferência | Banco e conta de transferência de origem. |
| Beneficiário | Nome e CPF/CNPJ. |
| Quantia | Valor em reais. |
| Lote | Número do lote, com link, quando a transferência está em um lote. |
| Origem | Manual (criada no painel) ou API. |
| Criado em | Data e hora de criação. |
O ícone de olho abre o detalhe. O ícone + ao lado do título Transferências abre a tela Nova Transferência.
Filtros
Clique em Filtrar para buscar por:
- UID da transferência;
- Conta de Origem;
- UID da conta de transferência;
- Nome do beneficiário;
- Número Documento do beneficiário;
- Tipo de transferência;
- Situação;
- Criação (De / Até);
- Agendamento (De / Até);
- Quantia (De / Até);
- Origem (Manual ou API).
Exportação
A lista exporta as transferências filtradas em CSV, XLSX ou ODS.
Detalhe da transferência
O título mostra o valor e a data, no formato "Transferência R$ 1.500,00 em 10/11/2026". A data é a de agendamento ou, sem agendamento, a de criação.
A aba Dados mostra: UID, Situação, Situação do Registro, Origem, Código de Autenticação, Data da Autenticação, Agendado para, Identificador (Pix), Lote, Quantia, Conta de Transferência, Beneficiário, Objetivo da Transferência, Tipo, e os dados do destino (tipo de Pix e chave, ou banco, conta e agência, ou banco e número do depósito judicial).
A Data da Autenticação é a data oficial da liquidação informada pelo banco: indica quando o valor saiu da conta.
Abaixo dos dados, a Timeline registra as datas de criação, registro, rejeição, falha ao reprovar e falha.
A aba Comandos lista as operações enviadas ao banco para esta transferência (registro, consulta, cancelamento e outras), com a situação de cada uma.
Quando a transferência é rejeitada, a lateral mostra Transferência Rejeitada e o motivo informado pelo banco.
O menu Ações tem:
| Ação | Quando aparece |
|---|---|
| Editar Transferência | Só quando a transferência pode ser editada (veja abaixo). |
| Cancelar | Sempre visível; habilitada só nas situações Pendente, Agendado e Aguardando Aprovação. |
| Webhooks enviados | Sempre. Abre o histórico de webhooks desta transferência em outra aba. |
Situações
| Situação | Significado |
|---|---|
| Pendente | Criada e ainda não processada pelo banco. |
| Aguardando Data Agendada | A transferência tem data futura e aguarda a data para seguir ao banco. |
| Agendado | O banco recebeu a transferência para uma data futura. |
| Aguardando Aprovação | O banco aguarda a aprovação (liberação) da transferência ou do lote. |
| Aprovado | A transferência foi aprovada e aguarda a efetivação. |
| Reprovado | A transferência foi reprovada na etapa de aprovação. |
| Aguardando Saldo | O banco aguarda saldo na conta para efetivar. |
| Finalizando | O banco está concluindo a transferência. |
| Confirmado | A transferência foi efetivada. |
| Rejeitado | O banco recusou a transferência. O motivo aparece no detalhe. |
| Cancelado | A transferência foi cancelada. |
| Vencido | Passou a data de expiração sem que a transferência fosse efetivada. |
Transições entre situações:
| Para | Vem de |
|---|---|
| Aguardando Data Agendada | Pendente, Agendado |
| Agendado | Pendente, Aguardando Data Agendada, Aguardando Aprovação, Vencido |
| Aguardando Aprovação | Pendente, Agendado, Aguardando Data Agendada |
| Aprovado | Pendente, Agendado, Aguardando Aprovação |
| Reprovado | Pendente, Agendado, Aguardando Aprovação |
| Aguardando Saldo | Pendente, Agendado, Aguardando Data Agendada, Aprovado, Aguardando Aprovação, Finalizando, Vencido |
| Finalizando | Pendente, Agendado, Aguardando Aprovação, Aprovado, Aguardando Data Agendada, Vencido |
| Confirmado | qualquer situação, exceto Reprovado, Rejeitado e Cancelado |
| Rejeitado | qualquer situação, exceto Reprovado, Confirmado e Cancelado |
| Cancelado | Pendente, Agendado, Aguardando Aprovação, Aprovado, Reprovado, Aguardando Data Agendada |
| Vencido | Pendente, Aguardando Aprovação, Aguardando Data Agendada |
| Pendente | Agendado, Aguardando Aprovação, Aguardando Data Agendada, Aguardando Saldo, Vencido (ao reagendar) |
Confirmado, Rejeitado e Cancelado são finais.
Situação do Registro
| Situação do Registro | Significado |
|---|---|
| Pendente | Ainda não enviada ao banco. |
| Requisitado | Enviada ao banco, aguardando resposta. |
| Confirmado | O banco aceitou o registro. |
| Rejeitado | O banco recusou o registro. |
| Falha | O envio falhou. |
Vencimento
Uma transferência só vence quando tem data de expiração, que pode ser informada pela API ou pela coluna "Vencimento" da importação por planilha. O formulário do painel não tem esse campo. Se a data de expiração cair em dia não útil, ela passa para o próximo dia útil. Passada essa data, a transferência que ainda está Pendente, Aguardando Data Agendada ou Aguardando Aprovação muda para Vencido.
Edição e reagendamento
A transferência pode ser editada enquanto todas estas condições valem:
- não está em um lote;
- a situação é Pendente ou Vencido;
- a situação do registro é Pendente (ainda não foi enviada ao banco).
Fora disso, o painel responde "Esta transferência não pode ser editada.".
Em Ações > Editar Transferência, a tela mostra os dados que não mudam (ID, situação, conta financeira, tipo e beneficiário) e permite alterar:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Quantia | Sim | Novo valor. Com validação de saldo ativa, um aumento de valor não pode passar do saldo da conta financeira. |
| Agendado para | Não | Nova data. Não pode ser no passado. |
| ID Externo | Não | Identificador externo opcional. Precisa ser único na conta. |
Clique em Salvar alterações. A mensagem "Transferência atualizada com sucesso." confirma a alteração.
Para reagendar, altere Agendado para. Uma transferência Vencido que recebe uma data de hoje em diante volta para Pendente.
Depois que o banco confirma o registro, a data só pode ser alterada pela API, com a operação de reagendamento, que envia um comando ao banco. O painel não tem essa ação.
Cancelamento
- Abra o detalhe da transferência.
- Clique em Ações > Cancelar. A opção fica habilitada nas situações Pendente, Agendado e Aguardando Aprovação.
- Confirme em "Você tem certeza que deseja cancelar esta Transferência?".
O que acontece depende de a transferência já ter sido enviada ao banco:
| Situação do Registro | Resultado |
|---|---|
| Pendente, Rejeitado ou Falha | A transferência muda na hora para Cancelado, sem contato com o banco. |
| Requisitado ou Confirmado | A Kobana envia um comando de cancelamento ao banco. A mensagem é "A transferência está em processo de cancelamento!" e a situação muda quando o banco responde. |
Se o banco não aceita cancelamento por comando, o painel mostra "A transferência não pode ser cancelada.".
Transferências de um lote também podem ser canceladas em conjunto, pelo próprio lote. Veja Lotes e aprovação.
Comprovante
Quando a transferência está Confirmado e o banco informou o código e a data da autenticação, a lateral do detalhe mostra Transferência Realizada e três links para copiar:
- Link do Comprovante;
- Link do Comprovante em PDF;
- Link do Comprovante em PNG.
Os links podem ser enviados ao beneficiário.
Permissões
Módulo Pagamento, produto Transferências: Ações Básicas para ver a lista e o detalhe, Alterar para editar e cancelar.
Webhooks
Cada transferência gera eventos que podem ser enviados por webhook:
| Evento | Quando |
|---|---|
transfer.db.created | A transferência foi criada. |
transfer.db.updated | A transferência foi alterada (inclusive mudança de situação). |
transfer.db.deleted | A transferência foi excluída. |
transfer.<tipo>.<operação>.<resultado> | Uma operação com o banco foi solicitada ou terminou. |
No último formato, <tipo> é pix, ted ou internal; <operação> é register, reschedule, approve, reprove, cancel, get ou sync; e <resultado> é requested, confirmed, failed ou error. Exemplo: transfer.pix.cancel.confirmed. A lista completa está em eventos de webhook.
Pela API
Consulta, listagem, cancelamento, aprovação e reagendamento de transferências estão na API v2.