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

> ## Agent Instructions
> Valora Payments API (Brazil: Pix, card, boleto). Base URL https://api.valorapayments.com.br, Authorization: Bearer sk_vl_... used only on the server. Request amounts are reais as strings ("149.90"); response amounts are integer cents (14990). Use POST /v1/checkouts for card and boleto; POST /v1/payments only creates Pix and should send an Idempotency-Key. Confirm payments only through the payment.succeeded webhook after verifying X-Valora-Signature (hex HMAC-SHA256 of "<t>.<raw body>"), dedupe by event.id and check livemode. Never invent endpoints or fields: check /llms.txt and /openapi.json.

# Frameworks

> Tutoriais passo a passo para integrar a Valora no seu framework: checkout, Pix e webhook com assinatura verificada.

Cada tutorial monta a mesma integração completa no seu framework:

1. Um cliente pequeno para chamar a API da Valora.
2. Uma rota que cria a compra e manda o cliente para o checkout.
3. Uma rota que recebe o webhook, verifica a assinatura e libera o pedido uma vez só.

> [card] [Next.js](https://dev.valorapayments.com.br/frameworks/nextjs.md)
>
> App Router, Route Handlers e Server Actions.

> [card] [Node.js com Express](https://dev.valorapayments.com.br/frameworks/express.md)
>
> API em Express com corpo cru no webhook.

> [card] [Laravel](https://dev.valorapayments.com.br/frameworks/laravel.md)
>
> Controllers, rotas de API e Http Client.

> [card] [Python com FastAPI](https://dev.valorapayments.com.br/frameworks/fastapi.md)
>
> Endpoints assíncronos com httpx.

## Antes de começar

Todos os tutoriais usam as mesmas três variáveis de ambiente:

```bash .env theme={null}
VALORA_API_KEY=sk_vl_...          # Desenvolvedores → Chaves de API
VALORA_WEBHOOK_SECRET=whsec_...   # aparece ao criar o webhook
VALORA_PRODUCT_ID=prod_...        # produto ativo que você vai vender
```

**1. Crie a chave de API**

No painel, em **Desenvolvedores → Chaves de API**, crie uma chave com as permissões `checkouts:write` e `payments:read`.

**2. Crie um produto**

No painel, em **Produtos**, ou com [`POST /v1/products`](https://dev.valorapayments.com.br/api-reference/produtos/criar-um-produto). Copie o id (`prod_...`).

**3. Exponha o servidor local**

O webhook precisa de uma URL pública com HTTPS. Em desenvolvimento, use um túnel:

```bash theme={null}
ngrok http 3000
```

**4. Cadastre o webhook**

Em **Desenvolvedores → Webhooks → Adicionar destino**, informe `https://SEU-TUNEL/api/webhooks/valora` (o caminho do tutorial) e guarde o segredo `whsec_...`.

> [!TIP]
>
> Usa um agente de IA para programar? Veja [IA e agentes](https://dev.valorapayments.com.br/ia/visao-geral.md) para dar a ele a documentação e as regras da Valora.


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