Changelog

As mudanças são aditivas a menos que digam o contrário: campos novos podem aparecer a qualquer momento, então o seu código deve ignorar o que não conhece. A api_version dos webhooks só muda em mudança incompatível.

2026-11-01 — Rastreio da venda (client_ref e tracking)

• Link de checkout: novo parâmetro client_ref (letras, números, - e _, até 100) para mandar um código do seu sistema. Veja Rastrear a venda com client_ref.
• Webhook V1: campo novo data.object.tracking nos eventos de venda e de pagamento e no checkout.session.abandoned, com client_ref, utm_source, utm_medium, utm_campaign, utm_content, utm_term, src e sck (só os que existirem). Sem mudança de api_version.
• Webhook legado: o trackProps, que vinha sempre vazio, passa a trazer as mesmas chaves. Nenhum outro campo do formato antigo mudou.
• API v1: campo tracking em GET /v1/transactions e GET /v1/transactions/{id}, e filtro ?client_ref=.
• Upsell, downsell e renovações de assinatura herdam o rastreio da venda de origem.