MEI com Stripe: como emitir NFS-e automática em cada venda

Se você é Microempreendedor Individual e cobra seus clientes pela Stripe — seja em venda avulsa via Checkout, Payment Link ou assinatura recorrente — cada pagamento aprovado gera uma obrigação fiscal: emitir a NFS-e correspondente.

Fazer isso manualmente no portal da prefeitura todo mês é lento, propenso a erro e simplesmente não escala quando você começa a ter 10, 50, 100 vendas por mês. O notafiscalmei resolve esse problema com uma integração direta entre a Stripe e o sistema nacional de NFS-e — e é gratuita para MEI.

O que a integração faz

Quando você conecta a Stripe ao notafiscalmei, configuramos um webhook que escuta dois eventos da sua conta:

• `checkout.session.completed` — disparado sempre que uma venda avulsa (Checkout ou Payment Link) é concluída.
• `invoice.paid` — disparado quando uma fatura de assinatura é cobrada com sucesso.

Ao receber qualquer um desses eventos, nosso sistema:

1. Valida a assinatura HMAC do webhook para garantir que veio mesmo da Stripe.

2. Extrai os dados do comprador (nome, email, CPF/CNPJ se coletado, endereço).

3. Sincroniza o próximo número de RPS com a prefeitura para evitar conflitos.

4. Emite a NFS-e pelo sistema nacional (ou portal da sua prefeitura, se aplicável).

5. Envia a nota por email ao cliente e disponibiliza no seu painel.

Tudo em questão de segundos, sem você fazer nada.

Quem deveria usar

Essa integração foi pensada para MEIs com perfil de prestador de serviço digital:

• Infoprodutores que vendem cursos, ebooks, mentorias
• Profissionais autônomos que emitem cobranças recorrentes (agências, consultorias, designers, desenvolvedores)
• SaaS em estágio inicial com poucos clientes PJ
• Coaches, terapeutas, nutricionistas que cobram sessões online pela Stripe

Se o seu fluxo envolve dezenas ou centenas de pagamentos pequenos por mês, a automação é essencial — sem ela você gasta horas emitindo nota e corre risco real de inadimplência fiscal.

Como configurar em 3 passos

1. Ative a integração Stripe no notafiscalmei

No painel do notafiscalmei, vá em Integrações e clique em Ativar no card da Stripe. Uma URL de webhook vai aparecer — algo como:

```

https://notafiscalmei.com/api/webhook/stripe?empresaId=

```

Copie essa URL.

2. Cadastre o endpoint no painel da Stripe

No dashboard da Stripe, navegue até Desenvolvedores → Webhooks e clique em + Adicionar endpoint. Cole a URL que copiou e marque dois eventos:

• `checkout.session.completed` (aba Checkout)
• `invoice.paid` (aba Invoice)

Salve. A Stripe vai gerar um Signing Secret no formato `whsec_...`. Esse é o segredo que permite ao notafiscalmei verificar que cada evento recebido veio legitimamente da Stripe.

3. Cole o Signing Secret no notafiscalmei

Volte ao painel do notafiscalmei e cole o `whsec_...` no campo correspondente. A integração fica ativa imediatamente.

Guardamos o Signing Secret criptografado com AWS KMS, amarrado a um contexto específico da sua empresa — mesmo que alguém conseguisse acesso ao banco, não conseguiria decifrar.

Um detalhe importante: dados do comprador

A Stripe não coleta CPF/CNPJ por padrão nos checkouts. Se você ativa a integração sem ajustar, as notas vão sair com tomador genérico ("CONSUMIDOR"), o que impede identificação fiscal e, em muitas prefeituras, causa rejeição da nota.

Solução: ao criar o Payment Link ou Checkout Session na Stripe, ative:

1. Coletar nome e endereço do cliente

2. Coletar ID fiscal (Tax ID) — a Stripe oferece um campo oficial para CPF brasileiro (`br_cpf`) e CNPJ (`br_cnpj`)

Com isso, o comprador digita o documento no próprio checkout, a Stripe inclui no payload do webhook, e o notafiscalmei preenche corretamente o tomador da NFS-e.

E os eventos que NÃO disparam nota?

Escolhemos apenas `checkout.session.completed` e `invoice.paid` porque cobrem os dois fluxos de venda (avulsa e assinatura) com metadados completos e sem risco de duplicação. Eventos que não emitem nota por design:

• `payment_intent.succeeded` — evento mais genérico da Stripe, dispara em todos os pagamentos. Se o escutássemos junto com os outros dois, emitiríamos duas NFS-e para a mesma venda.
• `charge.succeeded` — equivalente ao anterior no modelo legado de Charges.
• `customer.subscription.created` — criação da assinatura não significa cobrança ainda.

Se você depende de algum desses, nos avise — podemos avaliar casos específicos.

Dedupe e segurança contra retries

A Stripe pode retentar a entrega de um webhook várias vezes se o servidor responder com erro. Para evitar que a mesma venda gere 2 ou 3 NFS-e, nosso sistema usa o `event.id` da Stripe como chave de deduplicação — se o mesmo evento chegar duas vezes, a segunda é ignorada silenciosamente.

Preço

Gratuito enquanto durar a fase de crescimento do notafiscalmei. Não pedimos cartão, não cobramos por nota emitida, não temos limite de volume para MEI. No futuro planejamos cobrar, mas quem entrar agora fica grandfathered.

Comece agora

Se você já tem conta Stripe e MEI ativo, configurar a integração leva menos de 5 minutos. Acesse o painel, clique em Integrações e siga os passos. A partir da primeira venda aprovada, a nota chega automática no seu painel e no email do seu cliente.