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

Next.js

App Router, Route Handlers e Server Actions.

Node.js com Express

API em Express com corpo cru no webhook.

Laravel

Controllers, rotas de API e Http Client.

Python com FastAPI

Endpoints assíncronos com httpx.

Antes de começar

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

.env

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

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

Usa um agente de IA para programar? Veja IA e agentes para dar a ele a documentação e as regras da Valora.