Checkout pela API
Pix, cartão e boleto numa página pronta.
Pix direto
QR Code na sua própria tela.
Webhooks
A confirmação no seu servidor.
Pré-requisitos
- Uma conta no painel da Valora.
-
Uma chave de API de teste, guardada numa variável de ambiente do servidor:
- Para o checkout, pelo menos um produto ativo.
Escolha o caminho
Checkout pela API
Crie a compra
Redirecione o cliente
checkout.id (cs_...) junto do seu pedido. Ele ajuda a conciliar e a consultar o status com GET /v1/checkouts/{session_id}.
Pix direto pela API
payment.pix.qr_image e payment.pix.brcode ao cliente. Veja todos os detalhes em Pix.
Confirme pelo webhook
Cadastre um endpoint uma vez (no painel em Desenvolvedores → Webhooks ou comPOST /v1/webhooks) e trate os eventos:
Use o
external_reference (ou o metadata) do pagamento para achar o pedido no seu sistema. Veja como validar a assinatura em Webhooks.
Trate os erros
Toda resposta de erro tem o mesmo formato:Idempotency-Key em erros 5xx e de rede. Corrija a requisição em erros 4xx. Veja a lista em Erros.
Páginas relacionadas
Webhooks
Assinatura, novas tentativas e reenvio.
Testes
Valide cada forma de pagamento antes de produção.