Introdução

Explicação de como é o processo de criação do boleto bancário

  • O processo de gerar boleto na Paytime é realizado no módulo Banking.
  • A criação de um boleto bancário é um processo assíncrono.
    • Isso significa que, ao realizar a requisição para criação do boleto, a API retorna apenas a confirmação de recebimento da solicitação. A efetiva criação e evolução do status do boleto são informadas posteriormente via webhooks.

⚙️ Fluxo de Criação

  • Requisição: o cliente envia a requisição para criação do boleto via API.
  • Evento de criação: o webhook new-billet é disparado, confirmando que o boleto foi criado no sistema.
  • Atualização de status: o status do boleto evolui conforme o processamento:
    • O webhook updated-billet-status é disparado sempre que há alteração, como a transição para PENDING (aguardando pagamento), PAID, CANCELED, entre outros.

📌 Observação Importante

O boleto não deve ser considerado válido apenas com o retorno da requisição. É necessário aguardar os webhooks para acompanhar a evolução do status, especialmente o updated-billet-status.


Did this page help you?