Eventualmente, como medida de segurança, pode ser necessária a atualização dos tokens de integração da API de Pagamentos.
Para facilitar esse processo, disponibilizamos no portal Conta TecnoSpeed uma funcionalidade que permite gerar um novo token e realizar a transição de forma controlada, mantendo temporariamente o funcionamento do token anterior. Esse intervalo é denominado período de coexistência dos tokens.
Neste artigo, explicamos como gerar um novo token, atualizar suas integrações e encerrar o período de transição com segurança.
Antes de começar
Fique atento aos comunicados oficiais enviados pela TecnoSpeed por e-mail, que poderão informar a necessidade de atualização dos tokens e os respectivos prazos para sua realização.
Dependendo do processo de atualização, poderá ser estabelecido um período de coexistência, durante o qual o token anterior e o novo poderão funcionar simultaneamente. Isso permite que você atualize suas integrações de forma gradual, minimizando o risco de interrupções.
⚠️ Importante: sempre que a TecnoSpeed comunicar a necessidade de atualização do token, recomendamos que o procedimento seja realizado o quanto antes, respeitando os prazos informados. Após o encerramento do período de coexistência, o token anterior poderá ser invalidado, ocasionando falhas de autenticação nas integrações que ainda o utilizarem.
Passo a passo para atualizar o token
Passo 1 — Acesse o portal Conta TecnoSpeed
Acesse o portal Conta TecnoSpeed, pelo endereço:
Informe suas credenciais de acesso cadastradas junto à TecnoSpeed.
Passo 2 — Confirme o código de segurança (MFA)
Após informar suas credenciais, um código de verificação de 6 dígitos será enviado ao seu e-mail.
Insira o código na tela de confirmação para concluir o acesso ao portal.
Passo 3 — Localize a opção de geração do novo token
Na tela inicial do painel, localize e clique no botão:
Gerar token da API Pagamentos
⚠️ Atenção: caso essa opção não esteja disponível, verifique se você está utilizando o e-mail principal vinculado ao contrato, informado no momento da contratação.
Passo 4 — Valide a operação e configure o período de transição
Ao solicitar a geração do novo token, um segundo código de segurança (MFA) será encaminhado ao seu e-mail.
Para continuar:
- Informe o código de verificação recebido.
- Defina a data de encerramento do período de transição.
- Clique em Confirmar e gerar token.
⚠️ Importante: a data máxima permitida para o funcionamento simultâneo dos tokens é 30/11/2026, às 08h30.
Após o encerramento do período de transição, o token anterior deixará de funcionar.
Passo 5 — Copie e armazene o novo token com segurança
Após a confirmação, o novo token será exibido na tela.
Copie a chave gerada e armazene-a em um ambiente seguro.
Recomendações de segurança:
- Armazene o token de forma protegida, preferencialmente utilizando mecanismos de criptografia.
- Não compartilhe o token em canais públicos ou ambientes não seguros.
- Evite inserir o token diretamente no código-fonte das aplicações.
- Restrinja o acesso à chave apenas às pessoas e aos sistemas que realmente necessitam utilizá-la.
Passo 6 — Atualize suas integrações
Com o novo token disponível, atualize as configurações de autenticação das aplicações que utilizam a API de Pagamentos.
Caso sua solução possua múltiplos ambientes, aplicações ou clientes integrados, certifique-se de que todos os pontos necessários sejam atualizados.
Durante o período de transição, o token anterior continuará funcionando, respeitando a data de encerramento configurada e o prazo máximo estabelecido.
Recomendamos validar o funcionamento das integrações utilizando o novo token antes de desativar o anterior.
Passo 7 — Encerre o período de transição
Após confirmar que todas as aplicações e todos os clientes integrados estão utilizando corretamente o novo token, recomendamos encerrar o período de transição, mesmo que a data limite ainda não tenha sido atingida.
Para isso:
- Acesse novamente o portal Conta TecnoSpeed.
- Clique em Encerrar transição agora.
- Confirme a operação utilizando o código de segurança enviado ao seu e-mail.
Após essa confirmação, o token anterior será desativado.
⚠️ Atenção: antes de encerrar a transição, certifique-se de que todas as integrações necessárias estejam configuradas com o novo token, evitando falhas de autenticação.
Importante: atualização do modelo de autenticação
Além da substituição do token, a TecnoSpeed disponibilizou um novo modelo de autenticação para as APIs de Pagamentos, Open Finance, DDA e Extratos.
Esse modelo foi desenvolvido para ampliar a segurança das integrações e reduzir riscos associados ao formato anterior.
Clientes que já utilizam o novo modelo de autenticação não precisam realizar a substituição do token descrita neste artigo.
Embora o modelo anterior permaneça operacional até março de 2027, recomendamos que a migração seja priorizada, considerando os benefícios de segurança oferecidos pelo novo formato.
Para conhecer o procedimento de migração, consulte o artigo:
Precisa de ajuda?
Caso encontre dificuldades para acessar o portal, gerar o novo token ou atualizar suas integrações, entre em contato com nossa equipe de suporte técnico pelos canais oficiais de atendimento da TecnoSpeed.
Estamos à disposição para auxiliar durante o processo de atualização.
Comentários
0 comentário
Por favor, entre para comentar.