Gerenciar pagamentos
A tela Pagamentos reúne todos os pagamentos da conta, de qualquer tipo e origem. Dela você filtra, exporta, abre o detalhe, edita, cancela e inclui pagamentos em lotes.
Onde fica no painel
Pagamentos > Gerenciar.
Lista
| Coluna | Conteúdo |
|---|---|
| UID | Identificador do pagamento, com botão de copiar. |
| Situação | Dois ícones: a situação do registro no banco e a situação do pagamento. Passe o mouse para ver o nome. Veja Status do pagamento. |
| Tipo de Pagamento | Boleto, Conta de Consumo, Pix ou Tributo. |
| Conta de Pagamento | Banco e conta de pagamento que debita o valor. |
| Quantia | Valor em reais. |
| Lote de Pagamento | Número do lote, com link, quando o pagamento está num lote. |
| Origem | Manual (criado no painel), API ou DDA (criado a partir de um boleto DDA). |
| Criado em | Data e hora de criação. |
O ícone de olho abre o pagamento.
Filtros
Clique em Filtrar para buscar por:
- UID do Pagamento e ID do Lote;
- Conta de Origem (conta financeira) e UID da conta de pagamento;
- Tipo do Pagamento, incluindo cada tipo de tributo (Tributo DARF, Tributo GRU, Tributo ISS e outros);
- Situação e Origem;
- Criação e Agendamento (de/até);
- Quantia (de/até).
Exportação
A lista exporta os pagamentos filtrados em CSV, XLSX ou ODS.
Ações em massa
Marque os pagamentos na lista e escolha:
- Adicionar a um Lote: veja Lotes e aprovação.
- Cancelar: veja Cancelamento.
Detalhe do pagamento
O título mostra o valor e a data (de agendamento ou, sem ela, de criação), por exemplo Pagamento R$ 1.250,00 em 10/11/2026. A tela tem duas abas:
- Dados: UID, Situação, Tipo de Pagamento, Situação do Registro, Origem, Código de Autenticação, Data da Autenticação, Data de Agendamento, Identificador, Quantia, Conta de Pagamento e os campos do tipo (código de barras, beneficiário, dados do tributo). Abaixo, a Timeline com as datas de criação, registro, rejeição e falha.
- Comandos: as operações enviadas ao banco para esse pagamento (registro, liberação, cancelamento, consulta), com a situação de cada uma.
A Data da Autenticação é a data oficial da liquidação informada pelo banco: o dia em que o valor saiu da conta.
O menu Ações tem Editar Pagamento (quando o pagamento pode ser editado) e Webhooks enviados, que abre o log de webhooks desse pagamento.
Comprovante
Quando o pagamento está Confirmado e o banco informou o código e a data de autenticação, a lateral da tela mostra Pagamento realizado e os links, cada um com botão de copiar:
- Link do Comprovante;
- Link do Comprovante em PDF;
- Link do Comprovante em PNG.
Quando o banco rejeita o pagamento, a lateral mostra Pagamento Rejeitado e o motivo devolvido pelo banco.
Edição e reagendamento
Um pagamento pode ser editado quando cumpre as três condições:
- não está em nenhum lote;
- está na situação Pendente ou Vencido;
- a situação do registro é Pendente (ainda não foi enviado ao banco).
Fora disso, o painel responde Este pagamento não pode ser editado.
A tela Editar Pagamento mostra, sem permitir mudança, o ID, a situação, a situação do registro, o tipo de pagamento e a conta financeira. Os campos editáveis são:
| Campo | Descrição |
|---|---|
| Quantia | Novo valor, em reais. |
| Data de Agendamento | Nova data. Não aceita data no passado. |
| ID Externo | Identificador externo opcional. |
| Identificador | Identificador adicional opcional. |
| Campos do tipo | Código, beneficiário ou dados do tributo. O tipo de pagamento não muda. |
Clique em Salvar alterações.
- Reagendar um pagamento Vencido: ao salvar uma Data de Agendamento de hoje em diante, o pagamento volta para Pendente e pode seguir para um lote.
- Aumentar a quantia: com a Validação de Saldo ativa na conta de pagamento, o aumento é comparado com o saldo atual. Se for maior, a edição é recusada com Saldo insuficiente.
Cancelamento
- Na lista, marque os pagamentos.
- Clique em Cancelar. O modal Cancelar pagamentos informa quantos serão cancelados e quantos foram retirados da seleção por já estarem cancelados.
- Clique em Sim, continuar.
O cancelamento é processado em segundo plano: o painel mostra Aguarde uns instantes para que a execução seja realizada. Na tela de um lote, a aba Pagamentos tem a mesma ação Cancelar para os pagamentos daquele lote.
O que acontece com cada pagamento:
| Situação do pagamento | Resultado |
|---|---|
| Ainda não enviado ao banco (registro Pendente, Rejeitado ou Falha) | Passa para Cancelado na hora, se a situação permitir. |
| Já enviado ao banco (registro Requisitado ou Confirmado) | A Kobana envia o pedido de cancelamento ao banco. A situação muda quando o banco responde. |
| Confirmado ou Rejeitado | Não é cancelado. |
O cancelamento parte das situações Pendente, Agendado, Aguardando Aprovação, Aprovado, Reprovado, Rejeitado e Aguardando Data Agendada. Quando o banco não aceita cancelamento para aquele tipo de pagamento, o pedido é recusado e o pagamento continua como está.
Permissões
| Ação | Permissão (módulo Pagamento, produto Pagamentos) |
|---|---|
| Ver lista e detalhe | Ações Básicas |
| Criar | Criar |
| Editar e cancelar | Alterar |
| Adicionar a um lote | Criar no produto Lotes de Pagamento |
Pela API
Referência em API v2.