Authorization. Este guia fornece uma visão geral dos conceitos de autenticação e dos requisitos de segurança.
A autenticação segura é fundamental para a integração de APIs. A autenticação baseada em tokens da Localpayment garante que apenas solicitações autorizadas possam acessar os dados da sua conta e processar transações.
OAuth 2.0
Autenticação de token Bearer padrão do setor
Tokens de curta duração
Tokens de acesso de 60 minutos para maior segurança.
Requisitos de segurança
Criptografia HTTPS
Toda a comunicação via API deve usar HTTPS para proteger os dados em trânsito.
Somente no lado do servidor
As solicitações de API devem ser originadas somente de ambientes de servidor seguros.
Lista branca de IPs
Configure a lista de permissões de IP no painel de controle para autorizar chamadas de API.
Armazenamento seguro de credenciais
Utilize variáveis de ambiente ou sistemas de gerenciamento de segredos.
Endpoints de autenticação
Gerencie sua autenticação de API usando estes endpoints dedicados:Obtenha o token de acesso.
Obtenha novos tokens de acesso e atualização usando suas credenciais de API.
Atualizar token de acesso
Obtenha novos tokens de acesso usando seu token de atualização sem precisar se autenticar novamente.
Exemplo rápido
Gerar token:curl
curl
Expiração do token
O Localpayment utiliza tokens de curta duração para maior segurança:Token de acesso
60 minutos
Usado para requisições de API
Curta duração por segurança
Usado para requisições de API
Curta duração por segurança
Token de atualização
120 minutos
Usado para obter novos tokens de acesso
Longa duração por conveniência
Usado para obter novos tokens de acesso
Longa duração por conveniência
Ciclo de vida do token
- Obtenha os tokens: solicite um par de token de acesso e token de atualização com Obter token de acesso.
- Reutilize o token de acesso: envie o mesmo token de acesso em todas as requisições enquanto ele for válido.
- Renove ao expirar: quando o token de acesso expirar ou você receber uma resposta 401 Não autorizado, solicite um novo par com Obter token de acesso.
- Substitua o par armazenado: armazene os dois novos tokens e descarte os anteriores.
Uso do endpoint de atualizaçãoO endpoint Atualizar token de acesso continua disponível se a sua integração já o utiliza. Cada atualização bem-sucedida retorna um novo par de tokens, e o token de atualização que você enviou deixa de funcionar.Uma nova requisição a Obter token de acesso também invalida os tokens de atualização emitidos antes dela para o mesmo usuário e integração.
Boas práticas de gerenciamento de tokens
Um par de tokens por integração
Mantenha um único par de tokens por usuário e integração, compartilhado entre todos os seus processos e workers.
Substitua o par completo
Após cada solicitação ou atualização de token, armazene o novo token de acesso e o novo token de atualização.
Evite logins em paralelo
Não solicite tokens em paralelo com o mesmo usuário. Cada nova solicitação de token invalida os tokens de atualização anteriores.
Não repita uma atualização com falha
Se uma atualização retornar 401, solicite um novo token com Obter token de acesso em vez de repetir o mesmo token de atualização.
Tratamento de erros
401 Não autorizado
Token inválido ou expirado
Solução: solicite um novo token com Obter token de acesso. Se uma atualização retornar este erro, não repita o mesmo token de atualização.
Solução: solicite um novo token com Obter token de acesso. Se uma atualização retornar este erro, não repita o mesmo token de atualização.
401 Não autorizado
IP não incluído na lista de permissões
Obter token de acesso retorna “Invalid IP for user. Please validate that 203.0.113.10 is whitelisted in your account settings.”
Solução: adicione o IP do seu servidor à lista de permissões no painel.
Obter token de acesso retorna “Invalid IP for user. Please validate that 203.0.113.10 is whitelisted in your account settings.”
Solução: adicione o IP do seu servidor à lista de permissões no painel.

