CHECKOUT_VIEWED - Documentation

Corresponde ao evento interno checkout.viewed. Este evento usa um envelope próprio — não contém purchase, buyer nem lead: na visualização ainda não existe comprador identificado. É um evento opt-in: só é enviado se estiver marcado na configuração do seu webhook. É deduplicado por visitante — o mesmo visitante abrindo a mesma oferta várias vezes em uma janela de 6 horas gera um único evento.

Quando é disparado

Visitante abre a página do checkout de uma oferta
Antes de preencher nome, e-mail ou qualquer dado de pagamento

Payload

{
  "id": "550e8400-e29b-41d4-a716-446655440002",
  "creation_date": 1736524800000,
  "event": "CHECKOUT_VIEWED",
  "version": "2.0.0",
  "data": {
    "product": {
      "id": 1,
      "name": "Curso de Marketing Digital"
    },
    "offer": {
      "code": "abc12345",
      "name": "Oferta Black Friday",
      "price": {
        "value": 197.00
      }
    },
    "checkout": {
      "url": "https://pay.velan.app/abc12345"
    },
    "visitor": {
      "vid": "123e4567-e89b-12d3-a456-426614174000"
    },
    "tracking": {
      "source": "google",
      "utm_source": "google",
      "utm_medium": "cpc",
      "utm_campaign": "black-friday",
      "utm_content": null,
      "utm_term": null,
      "src": null,
      "sck": null
    }
  }
}

Campos

Campo	Descrição
`data.product`	Produto da oferta visualizada (`id` e `name`).
`data.offer`	Oferta visualizada: `code`, `name` público e `price.value`.
`data.checkout.url`	URL do checkout que o visitante abriu.
`data.visitor.vid`	Identificador anônimo do visitante (UUID). Use para correlacionar com o `lead.created` e os eventos de pedido do mesmo funil.
`data.tracking`	Parâmetros de URL da visita (UTMs, `src`, `sck`), no mesmo formato dos demais eventos.

Diferenças em relação aos eventos de pedido

Não há purchase nem buyer — nenhum dado pessoal é enviado.
Não há order_id/lead_id: a visualização acontece antes de qualquer registro.
O evento é deduplicado por visitante + oferta (janela de 6 horas).

​Quando é disparado

​Payload

​Campos

​Diferenças em relação aos eventos de pedido

Quando é disparado

Payload

Campos

Diferenças em relação aos eventos de pedido