Pular para o conteúdo principal
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
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:
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.