Como receber pagamentos por boleto
Gere boletos em BRL, entregue linha digitável ou PDF e aguarde a compensação antes de liberar o pedido.
Informe os dados exigidos
O boleto usa o método BOLETO e moeda BRL. Além de valor e referência, a integração envia a data de vencimento e os dados do pagador solicitados pela documentação, inclusive endereço.
Entregue as instruções ao pagador
Uma criação bem-sucedida devolve os dados públicos do boleto, como linha digitável, código de barras, vencimento, beneficiário e endereço do PDF quando disponível.
- Crie o pagamento no backend com uma idempotência exclusiva para o pedido.
- Mostre a linha digitável ou disponibilize o PDF retornado.
- Mantenha a cobrança como pendente enquanto aguarda a compensação.
- Atualize o pedido apenas após payment.paid ou uma consulta oficial indicar PAID.
Acompanhe vencimento e compensação
O boleto nasce pendente e sua confirmação é assíncrona. Uma linha digitável gerada não comprova pagamento, e o retorno do pagador também não substitui a consulta da transação.
Use a data de vencimento e os limites aceitos pelo ambiente. Se precisar repetir uma criação cujo resultado ficou incerto, consulte primeiro o ID ou a referência e mantenha a mesma chave de idempotência.
Precisa de ajuda com o seu caso?
Se a orientação não resolveu, fale com o suporte. Não envie senhas, códigos de acesso ou chaves de API.
Entrar em contato