Oi, DEV! 👋
Crie sua conta para acessar mais recursos do portal.

ProblemTestingInvalidOperationExceptionJSONQueryStringAPITesteHomologação

Chaves de teste só podem ser usadas com solicitações de teste

Ao utilizar uma chave de API de teste/homologação, a requisição retorna o erro: 🐞 Chaves de teste só podem ser usadas com solicitações de teste. Informe o campo 'Testing' como verdadeiro (true) no objeto de solici...

Atualizado em 20 de jun. de 2026, 14:51

Problema

Ao utilizar uma chave de API de teste/homologação, a requisição retorna o erro:

🐞 Chaves de teste só podem ser usadas com solicitações de teste. Informe o campo 'Testing' como verdadeiro (true) no objeto de solicitação.

Esse erro ocorre porque a API identificou que a chave utilizada pertence ao ambiente de teste, porém a requisição foi enviada sem informar explicitamente que se trata de uma operação de teste.

Isso pode acontecer tanto em requisições JSON quanto em chamadas utilizando Query String.

Solucao

Para resolver o problema, informe o parâmetro testing como true na requisição.

Se estiver utilizando JSON:

{
  "testing": true
}

Se estiver utilizando Query String:

?testing=true

Importante: Esse parâmetro é obrigatório ao utilizar credenciais/chaves de teste ou homologação.