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

# Autenticação

> Como autenticar com a API da Noxpay.

## URL base

```
https://checkout.noxpay.io
```

## Autenticação

Todas as requisições à API devem incluir sua chave de API no header `api-key`:

```http theme={null}
api-key: <key>
```

Sua chave de API está disponível no dashboard da Noxpay em **Settings → API Keys**.

<Warning>
  Nunca exponha sua chave de API em código client-side. Todas as requisições à API da Noxpay devem partir do seu backend.
</Warning>

## Respostas de erro

Todos os endpoints retornam corpos de erro em JSON:

```json theme={null}
{ "error": "Unauthorized" }
{ "error": "Bad Request", "details": "currency is required" }
{ "error": "internal error" }
```

| HTTP Status | Significado                                               |
| ----------- | --------------------------------------------------------- |
| `400`       | Corpo da requisição inválido ou campo obrigatório ausente |
| `401`       | Chave de API ausente ou inválida                          |
| `403`       | Autenticado, mas sem permissões suficientes               |
| `404`       | Recurso não encontrado ou não pertence à sua conta        |
| `500`       | Erro interno do servidor                                  |