Skip to content

Changelog

Changes are additive unless stated otherwise: new fields may appear at any time, so your code should ignore what it does not know. The webhooks’ api_version only changes on a breaking change.

2026-11-01 — Sale tracking (client_ref and tracking)

Section titled “2026-11-01 — Sale tracking (client_ref and tracking)”
  • Checkout link: new client_ref parameter (letters, digits, - and _, up to 100) to send a code from your system. See Track the sale with client_ref.
  • V1 webhook: new data.object.tracking field on sale and payment events and on checkout.session.abandoned, with client_ref, utm_source, utm_medium, utm_campaign, utm_content, utm_term, src and sck (only those that exist). No api_version change.
  • Legacy webhook: trackProps, which was always empty, now carries the same keys. No other field of the old format changed.
  • API v1: tracking field on GET /v1/transactions and GET /v1/transactions/{id}, and the ?client_ref= filter.
  • Upsells, downsells and subscription renewals inherit the tracking of the originating sale.