Data Exchange

How context and customer data flow between your system and the journey, including query parameters for non-PII and server-to-server channels for PII.

How data reaches the journey

Data flows through two channels. Query parameters carry non-PII context (country, booking references, product categories) from your platform to the journey. Server-to-server calls between the Cover Genius backend and your API handle customer PII — names, emails, addresses, and other personally identifiable information never pass through the browser.

Query parameters

Query parameters pass non-PII context to the journey when loading it.

The country parameter (ISO 3166-1 alpha-2, e.g. AU, US) is used for content localization. Beyond that, partners can pass any non-PII data relevant to their integration — booking references, product categories, session identifiers, or campaign tags. These are defined during onboarding based on what context the journey needs.

https://xcj.xcover.com/acme-travel/en/?country=AU&booking_ref=ABC123&product=motor

The journey reads these parameters on load and uses them to configure the flow, fetch content, or pass context to the Cover Genius backend. Work with your Cover Genius integration manager to define the parameters your integration requires.

Never include PII in query parameters. Personally identifiable information (names, emails, phone numbers, addresses, dates of birth, etc.) is exchanged exclusively through server-to-server channels.

Customer data (PII)

Customer PII is always exchanged server-to-server between the Cover Genius backend and your API. PII is never passed through URL parameters or any client-side channel.

The method for obtaining customer data depends on your authentication model. In all cases, the Cover Genius backend handles the data exchange — no PII flows through the browser.

Booking notifications

After a customer completes a purchase, Cover Genius notifies your system that a booking has been confirmed. The notification format and delivery method are configured during onboarding — contact your Cover Genius integration manager to set up endpoints and review the payload format for your integration.

Looking for real time, in browser or in app events instead, such as journey ready, offer selection, or purchase complete? See Messaging for the live event channel between your app and the journey.