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

# Introdução

> A API de Pagamentos da Valora oferece endpoints abrangentes para processamento de pagamentos, gerenciamento de assinaturas e entrega de produtos digitais. Nossa API RESTful segue os padrões da indústria com respostas detalhadas para todas as operações.

## URLs de ambiente

* Modo ao vivo: [https://api.valorapayments.com.br](https://api.valorapayments.com.br)

## Gerenciamento de chaves de API e autenticação

<Steps>
  <Step title="Chaves de API de acesso">
    Acesse o [Dashboard da Valora](https://dash.valorapayments.com.br) e faça login.
  </Step>

  <Step title="API aberta e webhooks">
    Acesse a seção API e Webhooks na barra lateral:

    1. Adicione o URL do seu Webhook — a Valora envia atualizações de status aqui.
    2. Copie sua chave de API — mantenha-a apenas no servidor, nunca a exponha no código do frontend.
  </Step>

  <Step title="Guarde sua chave em segurança.">
    Copie a chave gerada imediatamente e certifique-se de armazená-la em local seguro.
  </Step>

  <Step title="Autentique suas solicitações de API">
    Utilize suas chaves de API para autenticar todas as solicitações. Aplique o seguinte formato de autorização:

    ```shellscript theme={null}
    'x-api-key: YOUR_API_KEY'
    ```
  </Step>
</Steps>

## Limites de taxa

Nossa API utiliza um sistema de limitação de taxa de requisições com janela dupla e proteção contra picos de tráfego. Os limites são aplicados com base no seu método de autenticação e plano de negócios.

### Limites padrões

| **Endpoint** | Limite | **Janela** |
| ------------ | ------ | ---------- |
| `GET`        | 30 req | 60s        |
| `POST`       | 30 req | 60s        |

## Tratamento de erros

Para gerenciar erros de forma eficaz, consulte as seções *Códigos de Erro* e *Falhas de Transação* para obter orientações detalhadas.

<Columns cols={2}>
  <Column>
    <Card title="Códigos de erro" icon="triangle-exclamation" href="/api-reference/erro-codes">
      Explore os detalhes completos dos erros e suas soluções.
    </Card>
  </Column>

  <Column>
    <Card title="Falhas de transação" icon="brake-warning" href="/api-reference/transaction-failures">
      Obtenha informações sobre problemas comuns em transações e suas soluções.
    </Card>
  </Column>
</Columns>

## Webhooks

Receba notificações em tempo real sobre eventos de pagamento. Consulte nosso [Guia de Webhooks]() para obter instruções de configuração.

<Card title="Guia de Webhook" icon="webhook">
  Configure webhooks para notificações em tempo real e tratamento de eventos.
</Card>