A Super utiliza autenticação via Bearer Token com JWT (JSON Web Token) para garantir a segurança das suas APIs. Este documento explica como funciona o processo de autenticação e como utilizá-lo corretamente.

​
Visão Geral

  • Tipo de Autenticação: Bearer Token (JWT)
  • Tempo de Expiração: 3600 segundos (1 hora)
  • Formato do Token: JWT (JSON Web Token)

​
Obtendo as Credenciais

Para gerar um token de acesso, você precisará de duas credenciais essenciais:
  1. Public Key: Identificador público da sua conta
  2. Secret Key: Chave secreta para autenticação
Estas credenciais podem ser encontradas na sua Dashboard da Super, na aba de integração.
Mantenha suas credenciais em segurança e nunca as compartilhe. A Secret Key é especialmente sensível e deve ser tratada como uma senha.

​
Expiração do Token

Os tokens JWT têm um tempo de expiração de 1 hora (3600 segundos). Após este período, o token se torna inválido e você receberá um erro 401 (Unauthorized) ao tentar acessar as APIs. Exemplo de resposta de erro quando o token expira: 
{
  "data": {
    "message": "Unauthorized",
    "statusCode": 401
  }
}

​
Boas Práticas

  1. Renovação Proativa: Implemente a renovação do token antes da expiração
  2. Tratamento de Erros: Sempre trate o erro 401 adequadamente em sua aplicação
  3. Armazenamento Seguro: Armazene o token em memória e nunca em localStorage
  4. Monitoramento: Implemente logs para monitorar falhas de autenticação

​
Implementação

Para implementar a autenticação em sua aplicação, consulte nossa API Reference de Autenticação que contém exemplos detalhados de como gerar e utilizar o token.
Nunca exponha sua Secret Key no código frontend ou em repositórios públicos. Utilize variáveis de ambiente ou serviços de gerenciamento de segredos.

​
Exemplo de Uso

// Exemplo de como utilizar o token em uma requisição
const headers = {
  'Authorization': `Bearer ${seuTokenJWT}`,
  'Content-Type': 'application/json'
};

// Exemplo de requisição
fetch('https://api.superpagamentos.com/v1/seu-endpoint', {
  method: 'GET',
  headers: headers
});

​
Troubleshooting

​
Problemas Comuns

  1. Token Expirado
    • Sintoma: Erro 401
    • Solução: Gerar um novo token
  2. Credenciais Inválidas
    • Sintoma: Erro 401
    • Solução: Verificar Public Key e Secret Key
  3. Token Mal Formatado
    • Sintoma: Erro 401
    • Solução: Verificar se o token está sendo enviado corretamente no header
Em caso de dúvidas ou problemas com a autenticação, entre em contato com nosso suporte técnico.