> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/get-started/readme/implementation-roadmap.md).

# Implementation roadmap

Typical sequence to launch a wallet program with The Wallet Crew, from contract signature to go-live, with an incremental delivery approach.

This roadmap describes the typical sequence to launch a wallet program with The Wallet Crew. It starts at contract signature and ends at go‑live, with an agile delivery approach and small, testable increments.

<details>

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

* A retail brand launches a loyalty card and focuses first on POS scanning, then adds CRM campaigns.
* A venue integrates ticketing first to ensure entry works, then adds post-event engagement.
* A brand replaces plastic membership cards with a digital pass, using a phased rollout per region.
* A brand starts with a single “core” template, then adds seasonal or event-specific templates.

</details>

## Roadmap overview

Most wallet projects succeed when operations lead the design. The pass must work at the point of sale or at the gate before it becomes a marketing channel. The Wallet Crew therefore prioritizes early validation of the end‑to‑end chain: source systems → pass data → distribution → wallet installation → redemption.

The sequence below is the default. Some steps can overlap. The delivery approach stays the same: ship small increments, validate quickly on real devices, then expand scope.

## Project phases (contract → go-live)

{% stepper %}
{% step %}

### Contract and kickoff

This phase aligns on scope, stakeholders, and constraints. It sets the working cadence and defines what “done” means for the first release.

Typical outputs include a project calendar, a list of owners, and a first go‑live target.
{% endstep %}

{% step %}

### Requirements collection (workshop)

The Wallet Crew runs a dedicated workshop to capture brand needs and constraints. It is a working session, not a presentation. The goal is to converge on a first “minimal viable” wallet experience.

The workshop usually covers pass use case, distribution channels, redemption/scanning constraints, required data fields, consent/GDPR expectations, and reporting needs.
{% endstep %}

{% step %}

### Technical setup (tenant + wallets + custom domain)

This phase makes the platform ready for secure testing and future production issuance.

It typically includes:

* Tenant provisioning (QA and, when relevant, production).
* Apple Wallet configuration (certificates, push keys, signing identity).
* Google Wallet configuration (issuer account access, service account / API credentials).
* Custom domain setup for branded links and hosted pages, when required.

Related docs:

* Wallet provider setup: [Apple & Google Wallet](https://docs.thewalletcrew.io/configure/advanced-configuration/wallet/apple-and-google-wallet.md)
* Apple certificates: [Apple Wallet certificates](https://docs.thewalletcrew.io/configure/advanced-configuration/wallet/apple-and-google-wallet/apple-wallet-certificates.md)
* Google issuer setup: [Google Wallet account](https://docs.thewalletcrew.io/configure/advanced-configuration/wallet/apple-and-google-wallet/google-wallet-account.md)
* Custom domain: [Custom domain](https://docs.thewalletcrew.io/configure/advanced-configuration/platform/custom-domain.md)
  {% endstep %}

{% step %}

### IT architecture definition (system-of-record and data ownership)

This phase defines where The Wallet Crew sits in the overall IT landscape. It also clarifies which systems remain the source of truth for each data element displayed on the pass.

The key decision is the data flow: what triggers pass creation, how updates are computed, and how identifiers link a pass to brand systems over time.

Related docs:

* Data model and identifiers: [Pass data and sync](https://docs.thewalletcrew.io/developers-guides/pass-architecture/pass-data-and-sync.md)
  {% endstep %}

{% step %}

### Project definition and delivery in increments (agile)

This phase turns the scope into shippable increments. Each increment should be testable without future work. This reduces go‑live risk and avoids “big bang” rollouts.

A common breakdown is:

* Increment 1: one template + one distribution channel + one redemption path.
* Increment 2: updates lifecycle (field refresh, status changes, deactivation rules).
* Increment 3: segmentation, analytics, and operational tooling.
* Increment 4: marketing automation, notifications, and personalization at scale.
  {% endstep %}

{% step %}

### User experience flow (install → present → update)

This phase defines the customer journey and the operational journey. It includes entry points (“Add to Wallet”), install screens, fallback flows (desktop → QR), and how the pass is retrieved later.

Distribution choices typically map to these docs:

* [Enrolment form](https://docs.thewalletcrew.io/guides-enrolment/enrolment/enrolment-form.md)
* [On your website](https://docs.thewalletcrew.io/guides-enrolment/enrolment/on-your-website.md)
* [Via email](https://docs.thewalletcrew.io/guides-enrolment/enrolment/via-email.md)
* [On your mobile app](https://docs.thewalletcrew.io/guides-enrolment/enrolment/on-your-mobile-app.md)
  {% endstep %}

{% step %}

### Pass configuration (templates + fields + barcode)

This phase translates the UX and data model into a pass template configuration for Apple Wallet and Google Wallet. It covers branding assets, field layout, links, and barcode/QR payload.

Template configuration lives under:

* [Pass template editor](https://docs.thewalletcrew.io/configure/advanced-configuration/wallet/template-configuration.md)
* Design reference: [Pass types & templates](https://docs.thewalletcrew.io/guides-design/design/pass-types-and-templates.md)
  {% endstep %}

{% step %}

### Connect core tools first (ticketing, POS, CRM/loyalty)

The Wallet Crew recommends connecting the core operational systems before adding marketing layers. Wallet is a credential. It must work reliably where the pass is used.

This phase usually delivers:

* A working creation/update feed from core systems.
* A stable identifier strategy (membership number, ticket ID, gift card code, …).
* A validated redemption flow in real conditions (scanner, POS, entry gate).
  {% endstep %}

{% step %}

### Add marketing and engagement (optional, after core validation)

This phase adds lifecycle engagement such as wallet notifications, geolocation, and marketing automation connectors. It is easier to iterate once core issuance and redemption are stable.

Entry points:

* Notifications: [Push notifications](https://docs.thewalletcrew.io/guides-animation/engage-and-animate/automatisation/push-notifications.md)
* Location triggers: [Geolocated notifications](https://docs.thewalletcrew.io/guides-animation/engage-and-animate/geolocated-notifications.md)
* Marketing connectors: [Marketing automation](https://docs.thewalletcrew.io/connectors/marketing-automation.md)
  {% endstep %}

{% step %}

### Go-live and operations

This phase completes production readiness: monitoring, support runbooks, and controlled rollout. It also defines how changes are shipped after go‑live (template updates, field additions, new increments).

Typical validation includes a production pilot, real-device checks on iOS and Android, and scanning tests in representative environments.

After go-live, see [After Go-Live: Best Practices](https://docs.thewalletcrew.io/policies/after-go-live-best-practices.md).
{% endstep %}
{% endstepper %}

## Common deliverables (what “done” looks like)

At go‑live, the minimal expected package usually includes one pass template, one distribution flow, and one operational redemption flow. It also includes a clear update strategy, so the pass remains trustworthy after installation.

As the program scales, deliverables expand to additional templates, segmentation, reporting, and optional engagement features.

## FAQ

<details>

<summary><strong>Why does The Wallet Crew recommend connecting core systems before marketing tools?</strong></summary>

Because wallet is used in operational moments. If POS or ticketing redemption is unstable, marketing amplification increases support load. Once core issuance, updates, and redemption are reliable, marketing automation and notifications can be added safely.

</details>

<details>

<summary><strong>Can the scope be limited to a single template for the first release?</strong></summary>

Yes. A first increment can be one template, one distribution channel and one redemption path.

</details>

<details>

<summary><strong>Can the project start before Apple/Google accounts are fully approved?</strong></summary>

Yes, in most cases. Requirements, UX definition, and template design can start immediately. Wallet provider approvals and credentials must be completed before production issuance.

</details>

<details>

<summary><strong>Is a custom domain mandatory?</strong></summary>

No. A custom domain is recommended when branded links and brand-aligned hosted pages are required. Some projects start without it, then add it before go‑live.

</details>

<details>

<summary><strong>What typically causes delays?</strong></summary>

Delays usually come from external dependencies: wallet provider approvals, DNS changes for custom domains, security reviews, and clarifying data ownership between systems. Keeping increments small reduces the impact of these delays.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/get-started/readme/implementation-roadmap.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
