Skip to main content
O boleto é ideal para clientes que preferem pagar no banco ou que não usam PIX. A cobrança nasce com status pending e passa a paid quando a compensação é confirmada — o que você recebe por webhook.

​
O que o cliente recebe

Ao criar um boleto, a API devolve tudo o que o cliente precisa para pagar:

Linha digitável

O código (digitableLine) que o cliente digita no app do banco.

URL do boleto

Um link (url) para visualizar e imprimir o boleto.
A resposta também traz o barcode (código de barras) e a data de vencimento (dueAt).

​
O que acontece depois de criar

1

Você cria a cobrança

A API responde com status: "pending" e os dados do boleto. Guarde o id da transação.
2

O cliente paga

Ele paga o boleto no banco ou pela linha digitável.
3

Você recebe o webhook

A compensação pode levar 1 a 3 dias úteis. Quando confirmada, chega um transaction_paid com status: "paid".
Diferente do PIX (confirmação em segundos), o boleto não é instantâneo. Não libere o pedido na criação — espere o transaction_paid.

Referência: criar boleto

Corpo completo da requisição, campos de customer e formato da resposta.