Guias

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:

CampoConteúdo
invoice_pdfA ligação para descarregar o PDF da fatura
hosted_invoice_urlO 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_url do 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:

  1. 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.
  2. No Dashboard da Stripe, instale a app Sealed Print a partir do Stripe App Marketplace e abra as definições.
  3. Cole o URL em URL do endpoint de API.
  4. 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.
  5. Selecione Guardar e depois Verificar a ligação. Quando aparecer “Está tudo pronto”, os documentos novos são impressos.

O que é impresso e quando:

DocumentoImpresso quando
FaturasA fatura é finalizada, enviada ou paga (à escolha)
Notas de créditoA nota de crédito é criada
OrçamentosO 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.

Print and sign from anywhere

Os signatários assinam por ligação de e-mail sem conta; todos recebem o PDF selado. No Free paga apenas por assinatura.

Mais guias e modelos