Sandbox e testes

Teste a integração numa loja real sem mexer em pedidos de verdade, no catálogo nem na emissão fiscal.

Tokens de teste

Crie em Aplicativos e API → Tokens, escolhendo o ambiente Teste. O token começa com tfs_test_.
Ele enxerga somente pedidos de teste: listas, detalhes e eventos.
Não altera o catálogo: escritas em produtos, preços e estoque recebem 403 sandbox_read_only.
Pode percorrer o fluxo dos pedidos de teste (acknowledge, NF-e, envio) sem efeito fiscal.

Pedidos de teste com token de produção

Tokens tfs_live_ ignoram pedidos de teste, a menos que você envie include_test=true. Esses pedidos trazem test: true, inclusive nos webhooks, e a NF-e deles é recusada com test_order.

Como criar pedidos de teste

No painel, use Pedido de teste (no checklist de publicação ou no início). A loja abre em modo de teste, mesmo antes de ser publicada.
Pague com o cartão 4111 1111 1111 1111 (aprovado) ou 4000 0000 0000 0002 (recusado), ou simule o pagamento Pix.
O pedido fica marcado como teste e não entra nas métricas. No fim, Concluir teste cancela ou reembolsa o pedido e devolve o estoque.

Antes de ir para produção

A assinatura dos webhooks é verificada e webhook-id repetido é ignorado.
Há polling com export_status=pending como rede de segurança.
Todos os POST levam Idempotency-Key.
429 e Retry-After são respeitados.
Pedidos com test: true nunca viram NF-e.
app.uninstalled é tratado: parar as chamadas e apagar os dados.