Este fluxo descreve o funcionamento da emissão e liquidação de boletos bancários, incluindo a opção de pagamento via Pix (Boleto Pix).
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_idpara conciliação - Trate reprocessamento de eventos
Próximos passos
Para detalhes técnicos, consulte os endpoints de Boleto na API Reference.