# The Wallet Crew components

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

<details>

<summary><strong>Real-world examples</strong></summary>

* **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.

</details>

### 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.

<div data-with-frame="true"><figure><img src="https://3566051324-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2FDijqZrwpAQtZUzznAnPU%2Fimage.png?alt=media&#x26;token=5ad153a4-f86d-44c3-bbf4-0db2a9f6b22e" alt="Diagram of The Wallet Crew components involved in the Bloomreach integration"><figcaption><p>Main building blocks: activities, events, and connector-side components.</p></figcaption></figure></div>

#### Configuration fields

The general settings screen contains:

* **API Key & Secret**: Bloomreach project access.
* **Project Token**: Bloomreach environment identifier.
* **Base URL**: Bloomreach API endpoint.

{% hint style="info" %}
The connector must be enabled on the tenant. This is typically done by The Wallet Crew team.
{% endhint %}

### 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, ...).

{% hint style="info" %}
Matching rules and field mappings can be customized. See [Extensibility](https://docs.thewalletcrew.io/connect/marketing-automation/bloomreach/extensibility).
{% endhint %}

### FAQ

<details>

<summary><strong>Can one pass use Bloomreach plus other data providers?</strong></summary>

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.

</details>

<details>

<summary><strong>Does PassDataProvider overwrite pass fields?</strong></summary>

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

</details>

<details>

<summary><strong>When does Bloomreach data appear on the pass?</strong></summary>

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

</details>