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_refparameter (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.trackingfield on sale and payment events and oncheckout.session.abandoned, withclient_ref,utm_source,utm_medium,utm_campaign,utm_content,utm_term,srcandsck(only those that exist). Noapi_versionchange. - Legacy webhook:
trackProps, which was always empty, now carries the same keys. No other field of the old format changed. - API v1:
trackingfield onGET /v1/transactionsandGET /v1/transactions/{id}, and the?client_ref=filter. - Upsells, downsells and subscription renewals inherit the tracking of the originating sale.

