Timezone standardisation ensures that all date and time values across Capillary are handled in a consistent and predictable way, regardless of where customers, servers, or downstream systems are located.

By standardising timezone handling, Capillary achieves the following at a platform level:

Eliminates ambiguity in date and time values across APIs (v1 APIs are excluded), events, and UI.
Enables accurate timezone-based promotions, evaluated using the customer’s local time.
Ensures consistent ordering and processing of transactions and events globally, independent of server location.
Preserves original local time context by capturing timezone offsets alongside normalised timestamps.
Removes the need for manual timezone handling in client applications once the configuration is enabled.

Timezone standardisation is applied uniformly across APIs, transaction processing, event notifications, behavioural events, and Member Care, while maintaining backward compatibility through shadow fields where required.

Availability and enablement of timezone standardisation

Timezone standardisation capabilities (API formats, shadow fields, offset preservation, and event handling) are available across the platform for all organizations, regardless of when the organization was created.

However, full end-to-end behaviour is controlled by configuration flags.

Organizations created from 2026 onwards
Timezone standardisation–related configurations are enabled by default. UI display, loyalty processing, and promotion evaluation follow the standardised behaviour automatically.
Organizations created before 2026
The standardised APIs and response formats are already available.
However, certain configurations that control behaviour in the UI and Loyalty processing are gated and may remain disabled.

To enable complete timezone standardisation for older organizations, create a support ticket to the Capillary Product Support team and enable the timezone standardization configuration.

Timezone standardization is not applicable for the below modules:

Insights (both UI and BE)
Badges UI
Offers (UI & API)
Rewards catalog (Marvel)
v1 APIs