Boleto bancário

​

Quando usar o boleto

• Cliente sem cartão ou que prefere pagar depois, dentro de um prazo.
• Faturas e mensalidades com data certa, em que vale cobrar juros e multa pelo atraso.
• Empresas que pagam por boleto no fluxo de contas a pagar.

​

Como funciona o boleto

• Valor mínimo: R$3,00 (`300` centavos). Abaixo disso, a API responde `O valor mínimo para boleto é R$ 3,00 (300 centavos)`. No checkout, o mínimo vale para o total dos itens.
• Dados de quem paga: o boleto exige nome e CPF/CNPJ. No checkout e no link, o cliente preenche. No checkout transparente, você envia em customer.
• Liberação: o boleto precisa estar liberado na sua conta. Sem isso, a API responde BOLETO is not available for this store.
• Sem reembolso: boleto pago não pode ser reembolsado. Veja Reembolsos.

​

Vencimento do boleto

• Sem dueDate: o boleto vence em 3 dias úteis, contados a partir do momento em que ele é gerado.
• Data no passado: recusada com dueDate cannot be in the past.
• Prazo máximo: 365 dias. Depois disso, a API responde dueDate cannot be more than 365 days in the future.
• Formato errado: recusado com dueDate must be a valid date in YYYY-MM-DD format.
• Hora do vencimento: o boleto vence no fim do dia, no horário de Brasília. A resposta traz esse momento em expiresAt.

​

No link de pagamento, a data fica fixa

​

Depois do vencimento

• Sem juros nem multa: o boleto expira (EXPIRED) e não aceita mais pagamento.
• Com juros ou multa: o boleto continua aberto depois do vencimento, e o cliente paga com o acréscimo. Veja Juros e multa no boleto.

​

Pix no boleto

• Pelo Pix do boleto: a confirmação sai em segundos, e vale a taxa de Pix.
• Pelo código de barras ou pela linha digitável: vale a taxa de boleto, e a confirmação depende da compensação bancária, que leva até 3 dias úteis.

​

Código de barras e linha digitável

​

Pelo dashboard

1. Em Sua Loja → Cobranças, clique em Criar cobrança. Para um link que vários clientes pagam, use Sua Loja → Links de pagamento → Criar link de pagamento.
2. Em Métodos de pagamento, marque Boleto. A opção só aparece se o boleto estiver liberado na sua conta.
3. Escolha produtos que somem pelo menos R$ 3,00.
4. Mande o link ao cliente. Ele escolhe Boleto, preenche os dados e clica em Imprimir / Salvar Boleto.

​

Pela API

​

No checkout e no link de pagamento

{
  "methods": ["BOLETO", "PIX"],
  "dueDate": "2026-12-15",
  "items": [{ "id": "prod_abc123xyz", "quantity": 1 }]
}

​

No checkout transparente

{
  "method": "BOLETO",
  "data": {
    "amount": 5000,
    "dueDate": "2026-12-15",
    "description": "Fatura de dezembro",
    "externalId": "fatura-456",
    "customer": {
      "name": "Mariana Costa",
      "taxId": "987.654.321-00",
      "email": "mariana.costa@empresa.com.br",
      "cellphone": "(21) 99876-5432"
    },
    "metadata": { "faturaId": "fatura-456" }
  }
}

{
  "data": {
    "id": "bole_k8pqr2mnvx",
    "amount": 5000,
    "status": "PENDING",
    "devMode": false,
    "barCode": "00191878900000050000000002759288002193297817",
    "identificationNumber": "00190000090275928800021932978170187890000005000",
    "url": "https://app.abacatepay.com/pay/bole_k8pqr2mnvx/boleto",
    "brCode": "00020101021226580014BR.GOV.BCB.PIX...",
    "brCodeBase64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    "platformFee": 250,
    "interest": null,
    "fine": null,
    "receiptUrl": null,
    "expiresAt": "2026-12-16T02:58:59.000Z",
    "createdAt": "2026-12-01T14:22:10.381Z",
    "updatedAt": "2026-12-01T14:22:10.381Z",
    "metadata": { "faturaId": "fatura-456" }
  },
  "success": true,
  "error": null
}

​

Notificações

​

Testar no Modo Teste

• Checkout e link de pagamento: escolha Boleto na tela de pagamento e clique em Simular Pagamento.
• Checkout transparente: a API cria o boleto com código de barras e linha digitável de teste, que não pagam nada. A rota de simulação existe só para Pix.

​

Perguntas frequentes