O token de API é uma chave de autenticação que permite que sistemas externos se conectem com a plataforma da Kobana de forma segura.
Com ele, você pode integrar seu ERP, site ou qualquer outro sistema com as funcionalidades da Kobana, automatizando operações como emissão de boletos, consulta de pagamentos e muito mais.
Neste artigo, vamos mostrar o que é o token de API, para que serve e como encontrá-lo na sua conta da Kobana.
Quer conhecer mais sobre as possibilidades da API da Kobana? Confira nossa documentação completa para desenvolvedores!
O que é o token de API?
O token de API é uma sequência de caracteres única que funciona como uma "senha" para identificar e autenticar sua conta da Kobana quando um sistema externo faz uma requisição.
É por ele que a Kobana reconhece que a requisição é legítima e autoriza o acesso às funcionalidades.
Diferente de uma senha comum, o token de API é:
Específico para integrações: Usado exclusivamente para comunicação entre sistemas;
Revogável: Pode ser regenerado a qualquer momento por questões de segurança;
Permissionado: Respeita as permissões do usuário que o gerou.
Para que serve o token de API?
Com o token de API da Kobana, você pode:
Integrar seu sistema com mais de 30 bancos brasileiros;
Automatizar a emissão de boletos e Pix;
Consultar status de pagamentos em tempo real;
Realizar pagamentos e transferências;
Sincronizar extratos bancários;
Gerenciar clientes e operações financeiras;
Configurar webhooks para receber notificações automáticas.
A disponibilidade dessas operações depende das funcionalidades de cada banco. Entre em contato com o nosso suporte para entender melhor.
Encontrando o Token de API
Para visualizar seu token de API, acesse a sua conta da Kobana e clique em Integrações > API (Seu sistema -> Kobana) > Token de API.
Por que não consigo copiar o token de API?
Nessa página, você encontrará o campo Token de API. Por questões de segurança, o token fica mascarado por padrão, mostrando apenas os primeiros e últimos caracteres.
Atenção! Como o token de API é uma informação extremamente sensível, ele é mostrado apenas uma vez: no momento em que é criado. Ao criar o token na Kobana, você recebeu uma recomendação para salvá-lo em um local seguro.
Regenerando o token de API
Caso seja necessário, você pode regenerar seu token de API. Para isso, clique no botão Renovar Token na mesma página do token de API.
Importante! Ao renovar o token, o anterior deixa de funcionar imediatamente, o que significa que todas as integrações feitas com aquele token também deixam de funcionar. Certifique-se de atualizar todos os sistemas que usam a integração com o novo token.
Dicas de segurança para o token de API
Mantenha o token seguro: Nunca compartilhe seu token em repositórios públicos, e-mails ou chats;
Use variáveis de ambiente: Em aplicações, armazene o token em variáveis de ambiente, não diretamente no código;
Monitore o uso: Acompanhe regularmente os logs de API para identificar uso indevido;
Renove quando necessário: Se suspeitar que o token foi comprometido, renove imediatamente;
Permissões adequadas: Certifique-se de que o usuário que gerou o token possui apenas as permissões necessárias.
Precisa de ajuda? Nossa equipe de suporte está sempre disponível no chat da plataforma ou pelo e-mail suporte@kobana.com.br para auxiliar com sua integração.