Solução de Problemas (Troubleshooting)

Resolução guiada para os erros mais frequentes durante o desenvolvimento.

1. Erro 401 Unauthorized ao chamar endpoints

**Causa:** O token JWT expirou (validade de 1 hora) ou foi assinado para um ambiente diferente.

**Solução:** Chame novamente `POST /partner/auth/token` e garanta que o client_id usado corresponde ao mesmo ambiente (SANDBOX vs PRODUCTION).

**Causa:** O servidor receptor fez parsing do JSON antes de calcular o hash, alterando a ordenação de chaves ou espaços em branco.

**Solução:** Calcule o HMAC sobre o **Raw Body** (Buffer bruto recebido na conexão TCP) antes de qualquer middleware como `express.json()`.

**Causa:** A aplicação solicitou um endpoint cujo escopo não foi aprovado na aplicação ou não foi consentido pelo lojista.

**Solução:** Acesse o painel da loja em **Integrações > Parceiros** e verifique as permissões concedidas.