This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

The Wallet Crew components

Components in The Wallet Crew that connect wallet passes with Bloomreach data and workflows.

The Bloomreach integration is implemented as a connector plus optional components. These components read and write Bloomreach customer data as part of wallet flows.

Real-world examples
  • Loyalty: tier and points displayed on the pass are pulled from Bloomreach.

  • Forms: an enrolment form creates or updates Bloomreach contacts.

  • Personalization: Bloomreach segments drive which fields or offers appear on the pass.

Connector configuration (The Wallet Crew admin console)

The connector is configured in the Wallet Crew back-office. This configuration enables API calls to Bloomreach and event forwarding.

Diagram of The Wallet Crew components involved in the Bloomreach integration
Main building blocks: activities, events, and connector-side components.

Configuration fields

The general settings screen contains:

  • API Key & Secret: Bloomreach project access.

  • Project Token: Bloomreach environment identifier.

  • Base URL: Bloomreach API endpoint.

The connector must be enabled on the tenant. This is typically done by The Wallet Crew team.

PassDataProvider

PassDataProvider retrieves customer information from Bloomreach and exposes it to pass rendering. This makes Bloomreach a data source for fields displayed on Apple Wallet and Google Wallet passes.

Typical data includes tier labels, points, expiry dates, and personalization attributes.

What PassDataProvider is used for

  • Display Bloomreach attributes directly on the pass.

  • Refresh data when the pass is opened or explicitly updated.

  • Reduce duplicated storage across systems when Bloomreach is the CRM source of truth.

CustomerFlowElement

CustomerFlowElement can create or update a Bloomreach contact as part of a wallet flow. A common usage is linking an enrolment form submission to Bloomreach profile creation.

What CustomerFlowElement is used for

  • Create a Bloomreach contact from enrolment forms.

  • Update Bloomreach attributes when a customer edits their profile.

  • Control matching rules (email, phone, member ID, ...).

Matching rules and field mappings can be customized. See Extensibility.

FAQ

Can one pass use Bloomreach plus other data providers?

Yes. The Wallet Crew can merge data from multiple sources when the project is configured that way. Bloomreach can be used for profile attributes while another system remains the source of truth for transactional data.

Does PassDataProvider overwrite pass fields?

PassDataProvider exposes data to the pass template. What is displayed depends on the template field configuration.

When does Bloomreach data appear on the pass?

It appears after a pass refresh. Refresh can be triggered by an explicit update, or by the platform rules configured for the pass.

Last updated