Autenticação e Segurança

Autenticação 🔐

Proteja suas requisições à API com o token de autenticação obrigatório para acessar todos os recursos disponíveis.

Cabeçalho de Autenticação 🔑

Todas as requisições à nossa API exigem autenticação usando um token Bearer no cabeçalho Authorization. Esse token funciona como seu identificador único e deve ser mantido seguro em todos os momentos.

Obtendo Seu Token

Acesse o seu Painel
1 - DOC.png

Vá até a seção Integrações
2 - DOC.png

Clique em Configurações
3 - DOC.png

Chave Privada (Utilizado na API em Geral) | Chave Pública (Utilizado para o 3DS)
4 - DOC.png

Copie e guarde o token com segurança

⚠️ Aviso de Segurança: Nunca compartilhe seu token nem o envie para repositórios públicos. Utilize variáveis de ambiente para armazenar suas credenciais de autenticação.

Headers Obrigatórios

Inclua os seguintes headers em todas as suas requisições à API:

Chave	Valor
Authorization	Bearer <token>
Content-Type	application/json

Exemplos de Requisição 📝

💻 cURL

🟨 JavaScript

🐍 Python

Limites de Requisição⏱️

As requisições à API estão sujeitas a limites de taxa (rate limits) para manter a estabilidade do serviço.

Requisições por minuto	Limite diário
60	10,000
300	100,000
1000	Ilimitado

Se o limite for excedido, a API retornará o erro 429 Too Many Requests

Expiração e Renovação do Token 🔄

Por motivos de segurança, os tokens possuem prazo de validade. Para renovar seu token:

Gere um novo token antes que o atual expire

Atualize suas aplicações com o novo token

Teste para garantir que tudo está funcionando corretamente

Exclua o token antigo

Solução de Problemas de Autenticação ❓

Código de Erro	Descrição	Solução
401	Token inválido ou expirado	Verifique se está utilizando um token válido e ativo
403	Permissões insuficientes	Confirme se sua conta possui acesso ao recurso solicitado
429	Limite de requisições	Reduza a frequência de chamadas ou atualize seu plano

Precisa de ajuda? Entre em contato com nossa equipe de suporte para desenvolvedores.

Autenticação e Segurança

Autenticação 🔐#

Proteja suas requisições à API com o token de autenticação obrigatório para acessar todos os recursos disponíveis.#

Cabeçalho de Autenticação 🔑#

Obtendo Seu Token#

Headers Obrigatórios#

Exemplos de Requisição 📝#

💻 cURL#

🟨 JavaScript#

🐍 Python#

Limites de Requisição⏱️#

Expiração e Renovação do Token 🔄#

Solução de Problemas de Autenticação ❓#