Ambientes
Diferenças entre sandbox e produção — o que muda e o que não muda.
| Característica | Sandbox | Produção |
|---|---|---|
| Prefixo da chave | sk_test_ | sk_live_ |
| Base URL | sandbox.emitirnotafacil.com.br | api.emitirnotafacil.com.br |
| Sandbox público (sem conta) | sk_test_sandbox_demo | — |
| NFS-e enviada à Receita | ❌ simulada | ✅ real |
| Receita Federal | homologacao.nfse.gov.br | nfse.gov.br |
| Certificado A1 | certificado de homologação | certificado de produção |
| Cobrança Stripe | ❌ não cobrado | ✅ cobrado conforme plano |
| Webhooks entregues | ✅ sim (payload fake) | ✅ sim (payload real) |
| Rate limit sandbox demo | 20 req/hora por IP | conforme plano |
| PDF / XML da nota | ❌ não gerado | ✅ disponível |
Chaves de sandbox
sk_test_sandbox_demoPúblicoChave compartilhada, sem cadastro. Limite de 20 req/hora por IP. Dados resetam a cada reinício do servidor. Use apenas para explorar a API rapidamente.→ Playground
sk_test_<sua-chave>Sua contaGerada no cadastro. Associada à sua conta, isolada de outros MEIs. Usa o ambiente de homologação da Receita Federal — certificado de homologação necessário.
Migrando para produção
- 1Troque o certificado A1 de homologação pelo certificado de produção em POST /v1/auth/certificate
- 2Substitua todas as ocorrências de sk_test_ por sk_live_ no seu sistema
- 3Atualize a base URL para api.emitirnotafacil.com.br
- 4Ative uma assinatura Stripe (Trial, Starter, Basic, Pro ou Business)
- 5Teste o fluxo completo com uma nota de valor baixo antes de escalar
✓ Veja o checklist completo em
docs/deploy-checklist.md no repositório.