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

# Autenticação

> Como autenticar para fazer requisições API

Nossa API utiliza autenticação via **Bearer Token**. O token deve ser incluído no header `Authorization` de todas as requisições que requerem autenticação:

```bash theme={null}
Authorization: Bearer {seu_token_aqui}
```

Para acessar a API pública do Pepper, você precisa de um token de autenticação válido. Siga estes passos:

<Steps>
  <Step title="Acesse o Painel Pepper">
    * Faça login na sua dashboard
    * Vá até a seção de ["Configurações"](https://app-v2.pepperpay.com.br/settings/my-account) no menu lateral
    * Acesse a aba "API"
  </Step>

  <Step title="Pegue o seu token de autenticação">
    Localize o token e clique em "Copiar token".

    <img src="https://mintcdn.com/pepper-e5ac4c2d/2fOoaSYiODLZfte0/images/autenticacao-token-dashboard.png?fit=max&auto=format&n=2fOoaSYiODLZfte0&q=85&s=26af48a82682d65cd4fead067e53a08b" alt="Alt text describing the image" width="711" height="453" data-path="images/autenticacao-token-dashboard.png" />

    <Warning>
      Importante: Seu token é único e pessoal. Por questões de segurança, não compartilhe-o.
    </Warning>
  </Step>

  <Step title="Use o Token nas Requisições">
    Inclua o token no header `Authorization` de todas as requisições
  </Step>
</Steps>

## Base URL para todas as requisições

```
https://api.cloud.pepperpay.com.br/public/v1
```

## Exemplo de Autenticação

```bash Request theme={null}
curl -X GET "https://api.cloud.pepperpay.com.br/public/v1/transactions" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json"
  -H "Accept: application/json"
```

## Erros de Autenticação

<table class="border border-gray-950/10 dark:border-white/10 rounded-lg table">
  <thead>
    <tr class="text-gray-950 bg-gray-50 dark:bg-white/5 dark:text-gray-50 w-full">
      <th class="text-left p-2">Código</th>
      <th class="text-left p-2">Descrição</th>
      <th class="text-left p-2">Como resolver</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td class="p-2">**401**</td>
      <td class="p-2">Token inválido ou ausente</td>
      <td class="p-2">Verifique se o token está correto e presente no header</td>
    </tr>

    <tr>
      <td class="p-2">**403**</td>
      <td class="p-2">Token expirado ou sem permissão</td>
      <td class="p-2">Renove o token ou verifique as permissões</td>
    </tr>

    <tr>
      <td class="p-2">**429**</td>
      <td class="p-2">Muitas tentativas de autenticação</td>
      <td class="p-2">Aguarde antes de tentar novamente</td>
    </tr>
  </tbody>
</table>