Pagamento de boletos
O pagamento de boleto quita, pela conta financeira da sua empresa, um boleto emitido por qualquer banco. Você informa a linha digitável ou o código de barras, o valor, a data e o beneficiário.
Onde fica no painel
- Acesse Pagamentos > Gerenciar.
- Clique no ícone + ao lado do título Pagamentos (com a lista vazia, use Novo Pagamento ou Criar Pagamento).
- A tela Contas de Pagamento pede: Selecione a conta de pagamento para iniciar o pagamento. Ela lista cada conta de pagamento com as colunas Banco, Conta Financeira, Saldo e Integrações. A busca aceita nome, número ou agência da conta.
- Na linha da conta que vai pagar, clique no ícone Boleto.
O mesmo passo 4 abre os outros tipos: Conta de Consumo, Pix e Tributo.
Formulário
O título da tela é Novo Pagamento, seguido do nome da conta financeira e do número da conta de pagamento. O seletor Tipo de Pagamento vem marcado com Boleto.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Tipo de Pagamento | Sim | Boleto, Conta de Consumo, Pix ou Tributo. |
| Quantia | Sim | Valor a pagar, em reais. Precisa ser maior que zero. |
| Data de Agendamento | Sim | Data do pagamento. Não aceita data no passado. |
| Código de Barras ou Linha Digitável | Sim | Código de barras (44 dígitos) ou linha digitável (47 dígitos), só números. |
| Nome (Beneficiário) | Sim | Nome de quem recebe, até 99 caracteres. |
| CPF/CNPJ (Beneficiário) | Sim | Documento de quem recebe. |
Clique em Salvar pagamento. Cancelar e Voltar retorna à lista sem salvar.
O que acontece depois
- O painel mostra Pagamento criado com sucesso. e volta para a lista. O pagamento aparece com a situação Pendente e a origem Manual.
- Se algum campo não passar na validação, o painel mostra Não foi possível criar o pagamento. Por favor, verifique os erros abaixo.
- Para enviar o pagamento ao banco, inclua-o num lote. Veja Lotes e aprovação.
Regras
- Saldo: quando a conta de pagamento tem a Validação de Saldo Habilitada, a Kobana compara a quantia com o saldo atual da conta financeira e recusa o pagamento com Saldo insuficiente. Veja Contas de pagamento.
- Banco: a Kobana valida o pagamento contra as regras do banco da conta financeira. Um tipo de pagamento que o banco não oferece é recusado.
- Edição: enquanto o pagamento está fora de lote, na situação Pendente ou Vencido e com o registro Pendente, você pode alterar quantia, data, beneficiário e código. Veja Gerenciar pagamentos.
Para conferir se um boleto pode ser pago antes de criar o pagamento, use a Consulta de boleto.
Boletos recebidos pelo DDA
Boletos que chegam pelo DDA não precisam ser digitados: a ação Liberar para Pagamento cria o pagamento de boleto com os dados do título. Veja Boletos DDA.
Importação em lote
O menu Pagamentos > Importar > Pagamentos de Boletos cria vários pagamentos de boleto a partir de uma planilha.
Permissões
Criar pagamento exige a ação Criar no produto Pagamentos do módulo Pagamento.
Eventos de webhook
| Evento | Quando |
|---|---|
payment.db.created | Pagamento criado. |
payment.db.updated | Pagamento alterado, inclusive mudança de situação. |
payment.bank_billet.register.confirmed | Registro do pagamento de boleto confirmado pelo banco. |
payment.bank_billet.cancel.confirmed | Cancelamento confirmado pelo banco. |
Cada operação (register, approve, reprove, reschedule, cancel, get, sync) tem os resultados requested, confirmed, failed e error. A lista completa está em Eventos de webhook.
Pela API
Referência em API v2.