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

1. Acesse Pagamentos > Gerenciar.
2. Clique no ícone + ao lado do título Pagamentos (com a lista vazia, use Novo Pagamento ou Criar Pagamento).
3. 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.
4. 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.

dica

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.