Na VTEX, a autenticação de integrações via APIs é realizada por meio de appKey e appToken. Entretanto, existem alguns casos em que uma integração pode falhar por conta de erros relacionados a essas chaves de autenticação. Veja abaixo como solucionar alguns problemas comuns relacionados à autenticação por appKey e appToken:
Associação de appKey e appToken
Ao acessar Perfis de acesso, dentro do menu de Configurações da conta, é possível configurar perfis de acesso com níveis de acesso diferentes à plataforma.
Todo par de appKey e appToken quando criado não é vinculado a um perfil de acesso. Dessa forma, é necessário vincular ambas chaves a um perfil de acesso desejado.
Um dos motivos de erro na autenticação pode ser a falta de vínculo das chaves criadas a um perfil de acesso. Outro possível erro é a vinculação do appKey e appToken um perfil que, embora cadastrado, não tenha acesso para exercer determinada ação na plataforma.
Apenas o usuário Titular tem permissão para manipular as chaves, isso é, criar a appKey e o appToken usados em integrações com a loja.
Erro de digitação
Ambas chaves devem ser preenchidas nos seus respectivos campos, sem espaçamento e mantendo a caixa das letras - case sensitive. Um pequeno erro no preenchimento pode impedir o funcionamento da integração.
Você pode verificar possíveis erros de digitação nos campos no módulo Gerenciamento de conta, em Usuários.
O appToken é exibido para o usuário apenas no momento da sua criação, não podendo ser recuperado posteriormente.