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.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.