Guia

Checklist de produção

Lista para revisar antes de colocar a integração em uso real.

A chave fica em variável de ambiente ou cofre de segredos — nunca no código ou no navegador.
A chave tem apenas as permissões necessárias (e LGPD só se realmente precisar dos dados pessoais).
Se seu servidor tem IP fixo, ele está cadastrado na lista de IPs permitidos da chave.
Toda gravação envia Idempotency-Key.
Seu código trata 429 esperando o tempo de Retry-After e tenta de novo.
Erros são registrados com o request_id da resposta.
O receptor de webhooks valida a assinatura, responde rápido e ignora eventos repetidos (mesmo id).
Existe um plano de troca de chave (Regenerar) em caso de vazamento.

Suporte

Em caso de dúvida ou erro, envie ao suporte da SIX Informática o request_id da resposta (também no cabeçalho X-Request-Id), o horário aproximado e a rota chamada. Com isso localizamos a chamada exata nos logs.