Skip to main content

URLs de ambiente

Gerenciamento de chaves de API e autenticação

1

Chaves de API de acesso

Acesse o Dashboard da Valora e faça login.
2

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.
3

Guarde sua chave em segurança.

Copie a chave gerada imediatamente e certifique-se de armazená-la em local seguro.
4

Autentique suas solicitações de API

Utilize suas chaves de API para autenticar todas as solicitações. Aplique o seguinte formato de autorização:
'x-api-key: YOUR_API_KEY'

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

EndpointLimiteJanela
GET30 req60s
POST30 req60s

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.

Códigos de erro

Explore os detalhes completos dos erros e suas soluções.

Falhas de transação

Obtenha informações sobre problemas comuns em transações e suas soluções.

Webhooks

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

Guia de Webhook

Configure webhooks para notificações em tempo real e tratamento de eventos.