Skip to main content
Juros e multa são os acréscimos que o cliente paga quando quita o boleto depois do vencimento. Na AbacatePay, você define os dois ao criar o boleto, e com eles o boleto continua aceitando pagamento depois da data de vencimento.

​
Quando usar

  • Faturas, mensalidades e contas com data certa, em que o atraso tem custo para você.
  • Quando quer aceitar pagamento atrasado. Sem juros nem multa, o boleto expira no vencimento e não aceita mais pagamento.
Juros e multa existem só no boleto. Pix e cartão não têm vencimento.

​
Como funcionam os juros e a multa

  • Juros (interest): percentual ao mês, cobrado pro rata die, ou seja, proporcional aos dias de atraso. Cada dia de atraso cobra 1/30 da taxa mensal.
  • Multa (fine): cobrada uma única vez depois do vencimento. Pode ser um percentual do valor do boleto (PERCENTAGE) ou um valor fixo (FIXED).
  • Os dois são independentes: envie só interest, só fine, os dois ou nenhum. Valor 0 ou campo ausente quer dizer sem acréscimo.
  • Com juros ou multa, o boleto continua aberto depois do vencimento.

​
Unidades

Os percentuais vão em centésimos de percentual. Os valores em reais vão em centavos, como no resto da API.

​
Exemplos de cálculo

Boleto de R$ 200,00, com juros de 3% ao mês (interest.value: 300) e multa de 2% (fine.value: 200, PERCENTAGE), pago 15 dias depois do vencimento: Com multa fixa de R10,00(‘fine.value:1000‘,‘FIXED‘)esemjuros,omesmoboletopagocomatrasosaiporR 10,00 (`fine.value: 1000`, `FIXED`) e sem juros, o mesmo boleto pago com atraso sai por R 210,00, qualquer que seja o número de dias. O banco calcula o valor final no dia do pagamento.

​
Regras

  • Só com boleto. No checkout e no link de pagamento, interest ou fine sem "BOLETO" em methods dá 400 com interest/fine requires BOLETO in methods. Isso vale também quando methods é omitido, porque o padrão é Pix e cartão.
  • No checkout e no link, valores negativos são recusados com interest.value must be an integer >= 0 ou fine.value must be an integer >= 0.
  • fine.type é obrigatório junto com fine.value e aceita PERCENTAGE ou FIXED.
  • Juros e multa não mudam depois que o boleto é criado.

​
Pelo dashboard

Juros e multa são configurados só pela API. No boleto gerado, o cliente vê a multa e os juros antes de pagar.

​
Pela API

Envie interest e fine em Criar um checkout ou Criar um link de pagamento, com "BOLETO" em methods:
A resposta e a consulta do checkout trazem interest, fine e dueDate. Os campos ficam null quando não foram definidos.

​
No checkout transparente

Envie os mesmos objetos em data, com method: "BOLETO". Veja Criar cobrança Boleto.
A resposta, GET /v2/transparents/get e Listar cobranças trazem interest e fine do boleto, ou null quando não foram definidos.

​
Notificações

O boleto pago com atraso dispara os mesmos eventos do boleto pago em dia: checkout.completed no checkout e no link, e transparent.completed no checkout transparente. Veja Boleto.

​
Testar no Modo Teste

Crie o boleto com interest e fine e confira os campos na resposta. A simulação de pagamento paga o valor original, sem acréscimo, porque no Modo Teste não há atraso de verdade.

​
Perguntas frequentes

Ao mês. interest.value é sempre a taxa mensal, e o valor cobrado é proporcional aos dias de atraso.
"interest": { "value": 100 } e "fine": { "value": 200, "type": "PERCENTAGE" }. Os percentuais vão em centésimos: 100 = 1%.
Não. Os campos só valem com boleto. Sem "BOLETO" em methods, a API responde 400.
Sim. Com juros ou multa, o boleto continua aberto depois do vencimento, e o cliente paga com o acréscimo. Sem eles, o boleto expira.
Não. Use a API: interest e fine em /checkouts/create, /payment-links/create ou /transparents/create.