Pular para o conteúdo principal
Neste tutorial, você monta numa API Express:
  • POST /checkout: cria a compra e devolve o link do checkout;
  • POST /pix: cria uma cobrança Pix para mostrar na sua própria tela;
  • POST /api/webhooks/valora: recebe e verifica os eventos.

Pré-requisitos

Integração

1

Crie o cliente da Valora

valora.js
2

Monte o servidor (webhook antes do express.json)

A rota do webhook precisa do corpo cru. Registre express.raw nela antes do express.json() global.
server.js
3

Chame do front-end

O valor do Pix (amount) vem do corpo da requisição só para deixar o exemplo curto. No seu sistema, calcule o valor no servidor a partir do pedido, nunca confie no valor enviado pelo navegador.

Teste

Cadastre https://SEU-TUNEL/api/webhooks/valora em Desenvolvedores → Webhooks, faça uma compra de teste e confira a entrega com status 200.

Próximos passos

Pix

Validade, cancelamento e devolução.

Idempotência

Repita requisições sem cobrar duas vezes.