Como Criar Boleto Na Nubank

Gerar boleto no Nubank é simples, mas tem armadilha que quase ninguém menciona

Você abre o app, clica em gerar boleto e pronto. Pelo menos é assim que parece na tela. Na prática, a coisa funciona de duas formas distintas: boleto padrão do app para receber pagamentos, ou boleto de cobrança propriamente dito via sistema de cobrança da NuBank. A diferença entre os dois é importante, porque se você está tentando emitir boletos como ferramenta de recebimento recorrente, o caminho dentro do app vai te levar a uma coisa completamente diferente do que você espera. Se o objetivo é receber um pagamento pontual, como venda de produto ou serviço, o processo é direto. Abre o app, vai em pay, seleciona gerar boleto, coloca o valor, o vencimento e a descrição. O Nubank gera o código de barras e o código duplicável. Cópia e cola, envia pro cliente. Isso leva cerca de 30 segundos. Sem complicação.

Como criar boleto na nubank para recebimento recorrente

Agora, se você quer emitir boletos em massa, para clientes recorrentes, ou precisa de alguma personalização maior, o caminho pelo app individual não escala. Aí entra a API de pagamentos do Nubank. Você precisa ter conta PJ aberta, o que já é um filtro inicial. Contas PF não têm acesso à API de emissão de boletos com as funcionalidades avançadas. No meu caso, já precisade configurar isso pra uma empresa de serviços que trabalha com mensalidades. O primeiro problema que encontrei foi com a taxa de processamento. O Nubank cobra sobre cada boleto pago, e a taxa varia dependendo do tipo de conta e do volume. Não é fixa. Fiquei sabendo disso depois de emitir uns 20 boletos e notar que o desconto não batia com o que eu esperava. A solução foi entrar em contato com o suporte PJ para pedir uma planilha de tarifas personalizada, o que só funciona se seu volume for razoável. Para quem emite poucos boletos por mês, a conta padrão é o que vale mesmo.

O fluxo técnico pela API funciona assim: você autentica com client_id e client_secret, cria um objeto de cobrança informando valor, data de vencimento e descrição, e a API devolve o boleto com código de barras e linha digitável prontos. Tudo via REST, resposta em JSON. A documentação tá em developers.nubank.com.br. Se você já mexeu com qualquer API de pagamento brasileira, o padrão é familiar — semelhante ao que o Gerencianet e o ASCIO oferecem, mas com a particularidade de que o Nubank exige HTTPS e a autenticação é via OAuth 2.0. Uma coisa que muita gente não percebe: o boleto gerado pela API não tem geração automática de compensação visual. Ou seja, você não recebe aquele PDF bonitinho com o logo da empresa embutido. Recebe os dados brutos e precisa montar o arquivo você mesmo se quiser algo apresentável. Eu resolvi isso criando um template HTML simples que consome a resposta da API e gera um PDF com as informações formatadas. Leva cerca de 15 minutos de desenvolvimento inicial e depois é só manter o template atualizado se o layout precisar mudar.

Limitações que o app não te avisa

O Nubank não oferece webhooks para notificação de pagamento de boleto na conta PF. Na PJ com API, existe a opção de configurar callback, mas ainda assim o envio pode ter latência de alguns segundos a minutos. Se você precisa de confirmação em tempo real — tipo, liberar um serviço assim que o pagamento cair — vai precisar implementar uma verificação periódica (polling) no endpoint de consultade pagamentos. Fiz isso numa automação interna que verifica a cada 5 minutos se o boleto foi compensado, e funcionou sem dor de cabeça. O custo adicional é desprezível, mas é algo que não aparece em nenhum tutorial básico. Outro ponto: a validade do boleto. Por padrão, o Nubank define vencimento máximo de 90 dias a partir da data de emissão. Se você precisa de prazos maiores, como parcelamentos, o caminho é gerar múltiplos boletos com datas diferentes. A API permite isso, mas cada boleto é uma cobrança separada, com sua própria taxa. Já vi gente criar "pegadinhas" nisso usando datas de vencimento muito próximas, mas o sistema tratacada um como transação isolada mesmo.

Para quem precisa de mais flexibilidade — como boleto com endereço do pagador, instruções personalizadas, ou integração com sistema de faturamento — o Nubank sozinho não cobre. Aí a alternativa mais comum no mercado brasileiro é migrar para plataformas especializadas como o Mercado Pago, Gerencianet ou a própria Cielo, que oferecem painéis de emissão em lote, relatórios gerenciais e APIs mais completas. O Nubank funciona bem para emissão simples e isolada. Para operações recorrentes com volume, ele começa a showr suas limitações de forma clara. O app do Nubank muda de interface com frequência. Botões de lugar, nomes de opções que migram, telas que se reorganizam. O que era clicável em "Pay" num mês pode estar em "Cobrar" no próximo. A melhor prática é ir direto pelo atalho: digitar "boleto" na barra de busca do app e selecionar "Gerar boleto". Evita perder tempo caçando menus que foram realocados.