Fatura Stripe em PDF – descarregar e imprimir
Descarregue uma fatura Stripe em PDF no Dashboard ou pela API, encontre recibos, notas de crédito, orçamentos e faturas de taxas, e imprima faturas automaticamente.
Atualizado a 21 de outubro de 2026
Quem cobra com a Stripe acaba por precisar das faturas em ficheiro: para a contabilidade, para o contabilista certificado ou para um cliente que pede uma cópia. A Stripe cria um PDF de cada fatura finalizada, mas nem sempre mostra onde ele está. Este artigo explica como descarregar uma fatura Stripe no Dashboard, como o cliente obtém o PDF, como descarregar muitas faturas de uma vez pela API e onde se encontram os recibos, as notas de crédito, os orçamentos e as faturas da Stripe pelas suas próprias taxas. No fim, mostra como imprimir as faturas novas automaticamente.
A documentação da Stripe está disponível em português do Brasil. As etiquetas do Dashboard indicadas a seguir vêm dessa documentação ou, quando só existe a versão inglesa, aparecem em inglês. No seu Dashboard o texto pode variar ligeiramente.
Descarregar uma fatura Stripe em PDF
No Dashboard da Stripe, abra a página de faturas (Invoices). Ao passar o rato pelo menu de opções (⋯) de uma fatura da lista, aparece o botão para descarregar o PDF (Download PDF no Dashboard em inglês). O resultado depende do estado da fatura:
- Numa fatura em aberto, anulada ou incobrável, a Stripe gera um PDF da fatura.
- Numa fatura paga, o mesmo botão descarrega um PDF do recibo, não da fatura.
Para obter a fatura original de uma fatura paga, clique na fatura para abrir a página de detalhes e descarregue-a a partir daí.
Os rascunhos ainda não têm PDF. A Stripe cria-o no momento em que a fatura é finalizada.
A página de fatura alojada para os clientes
Ao enviar uma fatura, a Stripe cria um URL privado para uma página de fatura alojada. Nessa página, o cliente pode ver a fatura, pagá-la e descarregar cópias em PDF da fatura e do recibo. Se ativar nas definições de faturação a ligação para uma página de pagamento, o URL aparece também no e-mail da fatura e no rodapé do PDF.
Estas ligações não valem para sempre. Segundo a Stripe, os URL das faturas expiram 30 dias após a data de vencimento, ou 30 dias após a finalização se a fatura não tiver data de vencimento, e nunca depois de 120 dias. Quem abre uma ligação expirada é convidado a contactar a empresa ou, se a fatura foi enviada por e-mail, pode pedir uma nova cópia do e-mail.
O PDF da fatura pela API
Cada objeto Invoice da API da Stripe tem dois campos para isto:
| Campo | Conteúdo |
|---|---|
invoice_pdf | A ligação para descarregar o PDF da fatura |
hosted_invoice_url | O URL da página de fatura alojada |
Ambos são null enquanto a fatura não for finalizada. A ligação em invoice_pdf expira tal como a página alojada.
A Stripe garante que um URL acabado de obter pela API se mantém válido durante pelo menos 10 dias; por isso, volte a
consultar a fatura pouco antes de a descarregar. Uma ligação de PDF expirada responde com HTTP 400 a clientes que não
são um navegador, como o curl.
Recibos: e-mail, URL do recibo e PDF
A Stripe cria um recibo para cada pagamento e cada reembolso bem-sucedidos. Os clientes podem vê-lo no navegador e, se quiserem, descarregá-lo em PDF.
- Recibos automáticos por e-mail: no Dashboard, abra Configurações > Empresa > E-mails de clientes (Customer emails) e, em Pagamentos, ative Pagamentos bem-sucedidos ou Reembolsos.
- Enviar um recibo manualmente: abra Transações > Pagamentos, selecione o pagamento, vá a Histórico de recibos (Receipt history), abra o menu de opções (⋯) e selecione Enviar recibo. É possível indicar vários endereços de e-mail separados por vírgulas.
- Pela API: o atributo
receipt_urldo objeto Charge aponta para o recibo.
Por motivos de segurança, as ligações para os recibos expiram ao fim de 30 dias; o recibo em si não. Para imprimir um recibo, abra o URL no navegador e imprima a página, ou descarregue a versão em PDF na página do recibo e imprima-a.
Notas de crédito e orçamentos
As notas de crédito (credit notes) reduzem o valor de uma fatura em aberto ou paga. São emitidas na página de
detalhes da fatura com Mais ações > Emitir uma nota de crédito (Issue a credit note). Na API, o campo pdf do
objeto Credit Note contém a ligação para o PDF; aplicam-se as mesmas regras de expiração das faturas.
Os orçamentos (quotes) recebem um PDF assim que são finalizados. No editor de orçamentos é possível descarregar
uma pré-visualização em PDF de um rascunho. Depois da finalização, o PDF do orçamento descarrega-se na página de
detalhes. Na API, os orçamentos não têm um campo PDF, mas sim um método próprio:
GET https://files.stripe.com/v1/quotes/{id}/pdf com a chave secreta devolve diretamente o ficheiro. Atenção: a
Stripe exige o Invoicing Plus para finalizar, descarregar ou aceitar orçamentos de faturas únicas no modo real.
As faturas da Stripe pelas suas taxas
Outra coisa são as faturas que a Stripe emite pelas suas próprias taxas. Não são faturas para os seus clientes, mas a contabilidade precisa delas, por exemplo por causa do IVA. A Stripe disponibiliza estas faturas fiscais a empresas estabelecidas nos países suportados, incluindo a Europa. De acordo com o artigo de ajuda da Stripe «Baixar faturas fiscais para tarifas da Stripe», descarregam-se no Dashboard em Configurações > Planos e tarifas > Histórico de faturas (Settings > Plans and fees > Invoice history). Ficam disponíveis até ao dia 10 do mês seguinte. A Stripe não emite nenhuma para um mês sem atividade tributada ou se faltarem dados fiscais na conta. O caminho do menu já mudou no passado; se não as encontrar, consulte esse artigo.
Estas faturas só existem no Dashboard. A Stripe não oferece uma API para elas, por isso nem scripts nem apps as conseguem descarregar ou imprimir automaticamente.
Descarregar muitas faturas Stripe de uma vez
Tanto quanto a Stripe documenta, o Dashboard não tem um botão que descarregue os PDF de muitas faturas de uma só vez. As opções são:
- Exportar (CSV): na página de faturas, Export cria um ficheiro CSV com todas as faturas ou com uma seleção filtrada. Contém os dados das faturas, não os PDF. Os relatórios e o Sigma também entregam dados, não documentos.
- A API: liste as faturas e descarregue cada
invoice_pdf. É a forma fiável de obter todos os PDF, por exemplo para entregar ao contabilista no fim do mês. - Ferramentas de terceiros: apps do Stripe App Marketplace e extensões do navegador oferecem exportações em PDF como ficheiro ZIP. Antes de instalar, verifique que acesso aos dados da Stripe a ferramenta pede.
Um pequeno script Node.js com o pacote oficial stripe descarrega todas as faturas pagas a partir de uma data. Use
uma chave restrita com acesso de leitura às faturas:
import { writeFile } from "node:fs/promises"
import Stripe from "stripe"
const stripe = new Stripe(process.env.STRIPE_KEY)
const since = Math.floor(new Date("2026-10-01").getTime() / 1000)
for await (const invoice of stripe.invoices.list({ status: "paid", created: { gte: since }, limit: 100 })) {
const response = await fetch(invoice.invoice_pdf)
await writeFile(`${invoice.number}.pdf`, Buffer.from(await response.arrayBuffer()))
}
O ciclo for await percorre a lista página a página sozinho; a API devolve no máximo 100 faturas por pedido. Com o
curl, as faturas listam-se com
curl -G https://api.stripe.com/v1/invoices -u "rk_live_…:" -d status=paid -d limit=100 e a página seguinte obtém-se
com starting_after e o ID da última fatura da página anterior. Cada PDF descarrega-se com
curl -L -o INV-0042.pdf "<invoice_pdf>".
Imprimir faturas Stripe automaticamente
Com poucas faturas por mês, descarregar e imprimir à mão chega. Se as faturas têm de ir todos os dias para um dossiê, para dentro da encomenda ou para a secretária da contabilidade, a app Sealed Print para Stripe trata disso. A app instala-se a partir do Stripe App Marketplace e envia cada documento novo para a impressora escolhida, por exemplo no escritório ou no armazém. As impressoras ligam-se através do cliente relay num computador ou NAS, ou diretamente se suportarem IPP INFRA. Não é preciso abrir portas no router. Há mais exemplos na página Imprimir documentos do Stripe.
A configuração demora poucos minutos:
- No Sealed Print, vá a Origens → Endpoints de API e selecione Novo endpoint de API. Escolha a Rota e copie o URL do endpoint. Um admin tem de ter ativado o canal de entrada REST API em Definições → Canais de entrada. O funcionamento dos endpoints está descrito em Endpoints de API.
- No Dashboard da Stripe, instale a app Sealed Print a partir do Stripe App Marketplace e abra as definições.
- Cole o URL em URL do endpoint de API.
- Em Documentos, ative Imprimir automaticamente para cada tipo de documento. Escolha Quando é impresso, o número de Cópias e, se necessário, os Identificadores de outros destinos ou grupos de destinos.
- Selecione Guardar e depois Verificar a ligação. Quando aparecer “Está tudo pronto”, os documentos novos são impressos.
O que é impresso e quando:
| Documento | Impresso quando |
|---|---|
| Faturas | A fatura é finalizada, enviada ou paga (à escolha) |
| Notas de crédito | A nota de crédito é criada |
| Orçamentos | O orçamento é finalizado ou aceite |
| Recibos (experimental) | O pagamento é concluído ou reembolsado |
Cada documento é impresso uma vez por evento, mesmo que a Stripe volte a enviar o evento. Para imprimir uma fatura manualmente, abra-a no Dashboard da Stripe e selecione Imprimir com o Sealed Print no painel do Sealed Print.
Os limites: os rascunhos não têm PDF e só são impressos depois de finalizados. Os recibos são experimentais, porque a Stripe só os documenta como página web; a app imprime a versão em PDF, que a Stripe não documenta. A app não consegue imprimir as faturas de taxas da Stripe, já que só existem no Dashboard. Todos os passos e mensagens de erro estão no guia Imprimir documentos do Stripe. O Sealed Print cobra por entrega, ou seja, por um documento enviado para uma impressora; os planos estão na página de preços.
Perguntas frequentes
Onde se encontra o PDF de uma fatura Stripe?
No Dashboard, na página de faturas, no menu de opções (⋯) da fatura, com o botão de descarga do PDF. Numa fatura
paga, esse botão devolve o recibo; para a fatura em si, abra a página de detalhes. Na API, a ligação está no campo
invoice_pdf.
É possível descarregar todas as faturas Stripe de uma vez?
Em PDF no Dashboard não, tanto quanto a Stripe documenta. A exportação na página de faturas cria um ficheiro CSV com
os dados. Para os PDF, liste as faturas pela API e descarregue cada invoice_pdf, ou use uma ferramenta de
exportação de terceiros.
Porque é que a minha fatura Stripe não tem PDF?
Provavelmente ainda é um rascunho. A Stripe cria o PDF na finalização; até lá, invoice_pdf é null. As ligações
antigas também expiram, por isso volte a consultar a fatura para obter uma nova.
Onde estão as faturas das taxas da Stripe?
No Dashboard, em Configurações > Planos e tarifas > Histórico de faturas, para empresas de países em que as taxas da Stripe são tributadas. São faturas da Stripe para a sua empresa, não para os seus clientes, e não existe API para elas.
A Stripe consegue imprimir faturas automaticamente?
A Stripe não descreve uma função de impressão própria. A app Sealed Print para Stripe imprime automaticamente faturas, notas de crédito, orçamentos e, de forma experimental, recibos na impressora escolhida, assim que a Stripe os cria.