Skip to main content
A versão 1.0 continua funcionando e você não precisa migrar com pressa. Ela é o formato legado (descontinuado): não ganha novos recursos. Toda nova integração deve usar a versão 2.0 dos eventos.

​
Por que migrar

Dados de campanha

A 2.0 entrega o rastreamento (UTMs, src, sck) organizado no objeto tracking, além de url_params com os parâmetros da URL da compra.

Formato estruturado

Em vez de dezenas de campos soltos com sufixo _customer, a 2.0 agrupa em objetos (producer, tracking, cliente, produto), mais fácil de ler e manter.

Novos recursos

Melhorias e campos novos entram só na 2.0. A 1.0 fica congelada no que já existe.

​
O que muda no formato

A diferença principal é estrutural: a 1.0 é plana (todos os campos no topo, com nomes como name_prod, email_customer, utm_source), enquanto a 2.0 agrupa em objetos e padroniza os nomes.

​
Venda (postback principal)

Estas são as mudanças de maior impacto. Para o payload completo da 2.0, consulte Eventos de Venda (vários campos passam a viver dentro de objetos).
checkout_url, token, status, affiliates, coproducers e subscriptions existem nas duas versões.

​
Carrinho abandonado

Aqui o de-para é direto (as duas versões são planas):

​
Como trocar a versão

A versão é definida por webhook, no painel da Ticto. Recomendação:
1

Cadastre um webhook 2.0

Aponte para o mesmo endpoint que você já usa (ou um novo) e selecione a versão 2.0.
2

Ajuste seu recebedor

Atualize o código que lê o payload seguindo o de-para acima e as referências de Eventos de Venda e Carrinho Abandonado.
3

Valide em paralelo

Rode as duas versões lado a lado por um período, confira que a 2.0 chega correta, e só então desative a 1.0.
Não desative a 1.0 antes de confirmar que a 2.0 está sendo recebida e processada corretamente. Assim você não perde nenhum evento na transição.