Skip to main content
Quando um pedido muda de estado ou um carrinho é abandonado, a Corvex pode avisar o seu servidor com um HTTP POST em JSON. Você registra a URL e os eventos pela API v1 de webhooks.

Exemplos de payload

Corpos corvex.order.* e corvex.cart.abandoned, assinatura HMAC e boas práticas.

Gerenciar webhooks

Criar, listar, editar URL, eventos, secret e ver logs de entrega.

​
Fluxo

  1. Você cria o webhook com POST /api/v1/webhooks (URL HTTPS, lista de eventos, secret opcional).
  2. Quando o evento ocorre na loja, a Corvex envia POST para a URL.
  3. Seu endpoint responde 2xx rapidamente; processe o pedido de forma assíncrona se precisar.
  4. Falhas temporárias podem gerar novas tentativas — trate o mesmo id de forma idempotente.

​
Eventos

corvex.order.pending é interno e não é enviado a endpoints de lojistas.

​
O que vem no POST

Todo payload inclui um identificador do evento, o nome do evento e os dados do pedido ou do carrinho. Valores monetários vêm em reais (decimal), não em centavos. Exemplo resumido de pedido pago:
O exemplo completo e variações por evento estão em Payload dos webhooks.

​
Assinatura (recomendado)

Com secret configurado, valide o header X-Webhook-Signature (HMAC-SHA256 do body JSON). Detalhes e código em Payload dos webhooks.

​
Requisitos da sua URL

  • HTTPS público (sem localhost em produção).
  • Resposta 2xx em até alguns segundos.
  • Trate campos opcionais e null com segurança.
Sim. Passe vários valores em events ao criar o webhook. Use o campo event do body para rotear no seu código.
Use uma loja de homologação no painel, dispare um checkout de teste e confira os logs do webhook na API.
Webhooks avisam seu sistema. Automações enviam e-mail, SMS e WhatsApp pela Corvex — contratos diferentes.