> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticação

Utilizamos o OAuth 2.0 para autenticação da API. Saiba como gerar e usar tokens de acesso com segurança seguindo nossas práticas recomendadas.

Certifique-se de incluir o header `Authorization` com o esquema `Bearer` e seu token de acesso em cada solicitação que você enviar.

## Gere um token de acesso

Antes de fazer solicitações à API, você precisa obter um token de acesso enviando uma solicitação para o endpoint [Gerar um token de acesso](https://docs.localpayment.com/pt-br/reference/get-token.md).

### Exemplo de solicitação

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/token/ \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "username": "user@example.com",
  "password": "<PASSWORD>"
}
'
```

### Exemplo de resposta

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGccM5kYO7o4iOiJIU18jaiJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTczNTMxOTkyOSwianRpIjoiZWUxMDE3MTUwY2JhNGM1NTg0MjYyZmRkZTdiOThiNGQiLCJ1c2VyX2lkIjoxMDAwLCJzdXBlcnVzZXIiOnRydWUsImlzX3N0YWZmIjp0cnVlLCJybaCIsImV4cCI62xlcyI6WyJBTEwiXSwiY291bnRyaWVzIjpbIkFMTCJdLCJjb21wYW55IjoiQUxMIiwiY2xpZW50X2NvZGUiOiJBNzaW9uTEwiLCJwZXJtaXcyI6W119.6siymomkQ72yMvHGU9sMCO4h-cxpNgQXor",
  "access": "eyJ0eXAiOiJKV1QiLCJhJIUzI1NiJ9.eyJ0b2tlbl90eXBlIbGciOijoiYWNjZXNzIiwiZXhwIjoxNzM1MjMzODI5LCJqdGkiOiJiMDRmNzQ3YWEjOCIsIn4Mjg0YjM0YmMwN2Y4ZjVkOWM0NWFVzZXJfaWQiOjEwMDAsInN1cGVydXNlciI6dHJ1ZSwiaXNfc3RhZmYiOnRy3VudHJpZXMiOljpbIkFsiQUxMIl0sImNvbXBhbnkiOiJBTEwiLCJjbGllbnRfY29kZSI6IkFMTCIsInBlcm1pc3Npb25zIjpdWUsInJvbGVzIMTCJdLlqEnH7GrECJjbbXX0.sWOLKFxCcXQkUcPvTjYceXBp39hDF3-Snc"
}
```

***

## Utilize o token de acesso

Depois de receber o token `access`, inclua-o no header `Authorization` como um token Bearer em todas as solicitações subsequentes à API.

### Exemplo de solicitação

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/validation/document \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "country": "ARG",
  "document": {
    "id": "1791234561009",
    "type": "RUC"
  }
}
'
```

Veja informações detalhadas sobre [autenticação](https://docs.localpayment.com/pt-br/reference/authentication-overview.md).

### Melhores práticas para o uso de credenciais

Suas credenciais de API são essenciais para a integração com o Localpayment. Mantenha-as seguras seguindo estas boas práticas:

* Armazene as credenciais com segurança usando variáveis de ambiente ou gerenciadores de segredos: nunca as codifique diretamente no código nem as inclua em arquivos de controle de versão.
* Limite o acesso apenas a membros autorizados da equipe e revogue qualquer credencial que você suspeite estar comprometida.
* Utilize credenciais separadas para os ambientes de Sandbox e Produção.
* Monitore os registros da API regularmente para detectar atividades incomuns.
* Nunca exponha credenciais em código do lado do cliente, aplicativos móveis ou repositórios públicos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.