Resumo

O fluxo de boleto é indicado para cobranças que não exigem confirmação imediata, mas que podem ser liquidadas tanto via código de barras quanto via Pix.

Casos de uso comuns:

Pagamentos B2B
Cobranças com vencimento
Alternativa ao Pix tradicional
Migração gradual de boleto para Pix

Etapas do fluxo

Emissão do boleto
Disponibilização ao pagador
Pagamento via:
- Código de barras ou
- Pix (QR Code)
Processamento da liquidação
Emissão de eventos de pagamento
Atualização do status da cobrança

Estados

Estados comuns de um boleto:

CREATED
O boleto foi emitido e está disponível para pagamento.
PENDING
O boleto está aguardando pagamento.
PAID
O pagamento foi identificado e confirmado, independentemente do meio utilizado.
EXPIRED
O boleto venceu sem pagamento.
CANCELED
O boleto foi cancelado antes do pagamento.

Eventos

Durante o lifecycle do boleto, a Autra emite eventos como:

BOLETO_CREATED
BOLETO_PAID
BOLETO_EXPIRED
BOLETO_CANCELED

Os eventos representam a fonte de verdade sobre o estado da cobrança.

Diferença entre boleto tradicional e boleto Pix

A diferença entre boleto tradicional e boleto Pix está exclusivamente no meio de pagamento utilizado pelo pagador.

Aspecto	Boleto tradicional	Boleto Pix
Meio de pagamento	Código de barras	QR Code Pix
Confirmação	Assíncrona	Instantânea
Eventos	1 - Geração 2 - Registro do Boleto 3 - Pagamento	1 - Geração 2 - Registro do Boleto 3 - Pagamento 4 - Cancelamento do Registro

Pontos de atenção

O boleto não é pago no momento da emissão
Sempre aguarde o evento de liquidação
Não diferencie lógica por meio de pagamento
Utilize external_id para conciliação
Trate reprocessamento de eventos

Próximos passos

Para detalhes técnicos, consulte os endpoints de Boleto na API Reference.