Skip to main content
Disponível para: Empresa. Somente contas do tipo Empresa têm acesso às chaves de integração.
Uma chave de integração é um código único que identifica sua conta da Autorizou para sistemas externos, como o seu site, loja virtual ou sistema de gestão. Quando você configura uma integração, é essa chave que autoriza a comunicação entre o sistema externo e a Autorizou. Com as chaves de integração você consegue:
  • Criar chaves identificadas por nome para cada sistema que você conecta
  • Revogar uma chave imediatamente se ela for comprometida
  • Ter múltiplas chaves ativas ao mesmo tempo para integrações diferentes

​
Como criar uma chave de integração

1

Acesse a seção de integrações

No menu lateral, vá em Integrações → Chaves.
2

Inicie a criação

Clique em Nova chave.
3

Dê um nome descritivo

Escolha um nome que identifique para qual sistema essa chave será usada, por exemplo: Site principal ou Sistema de gestão. Isso facilita o gerenciamento quando você tiver várias chaves.
4

Confirme a criação

Clique em Criar chave.
5

Copie e guarde o valor da chave

O valor completo da chave será exibido uma única vez. Copie e guarde em local seguro antes de fechar essa tela.
O valor da chave aparece somente no momento da criação. Após fechar a tela, não é possível visualizá-lo novamente. Se você perder a chave, precisará revogá-la e criar uma nova.

​
Como revogar uma chave

Revogue uma chave sempre que ela for comprometida, vazar acidentalmente ou quando uma integração for desativada.
1

Acesse a lista de chaves

Vá em Integrações → Chaves.
2

Localize a chave

Identifique a chave pelo nome que você deu na criação.
3

Revogue a chave

Clique em Revogar ao lado da chave e confirme a ação.
A revogação é imediata e irreversível. Qualquer sistema usando essa chave perderá o acesso na hora. Certifique-se de ter uma nova chave configurada antes de revogar a antiga, se a integração precisar continuar funcionando.

​
Documentação técnica

Este guia cobre o gerenciamento das chaves pelo painel. Para detalhes técnicos de como usar a chave nas chamadas de integração, como cabeçalhos, autenticação e exemplos de requisição, consulte a documentação para desenvolvedores disponível no portal técnico da Autorizou.
Nunca exponha sua chave de integração em código público, repositórios abertos ou mensagens. Use variáveis de ambiente para armazená-la com segurança.

​
Boas práticas

  • Uma chave por sistema: crie chaves separadas para cada integração. Assim, se uma for comprometida, você revoga apenas ela sem afetar as outras.
  • Nomes descritivos: use nomes que identifiquem claramente o uso, facilitando auditorias futuras.
  • Revogação imediata: ao suspeitar de vazamento, revogue a chave e crie uma nova sem esperar.
  • Armazenamento seguro: guarde o valor da chave em um gerenciador de senhas ou cofre de segredos.

​
Dúvidas comuns

Não. O valor da chave só é exibido no momento da criação. Se você perder, revogue a chave atual e crie uma nova para substituí-la.
Você pode ter múltiplas chaves ativas simultaneamente. Não há um limite fixo padrão, mas recomendamos manter apenas as chaves que estão em uso ativo.
Não. Cada chave é independente. A revogação de uma chave afeta somente os sistemas que usam aquela chave específica.
No momento, as chaves não expiram automaticamente. Elas permanecem ativas até você revogar manualmente.
Fique atento a transações ou eventos inesperados no painel. Se suspeitar de uso indevido, revogue a chave imediatamente e crie uma nova.

​
Veja também

Webhooks

Configure notificações automáticas para a sua URL quando eventos ocorrerem na Autorizou.

Colaboradores

Controle quem da sua equipe pode acessar e gerenciar as integrações.