PHPackages                             nowo-tech/wallet-qr-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. nowo-tech/wallet-qr-bundle

ActiveSymfony-bundle[Utility &amp; Helpers](/categories/utility)

nowo-tech/wallet-qr-bundle
==========================

Symfony bundle to generate Google Wallet and Apple Wallet save links with QR codes for Android and iOS.

v3.0.1(2w ago)06MITShellPHP &gt;=8.2 &lt;8.6CI passing

Since Jun 10Pushed 2w agoCompare

[ Source](https://github.com/nowo-tech/WalletQRBundle)[ Packagist](https://packagist.org/packages/nowo-tech/wallet-qr-bundle)[ Docs](https://github.com/nowo-tech/WalletQrBundle)[ GitHub Sponsors](https://github.com/HecFranco)[ RSS](/packages/nowo-tech-wallet-qr-bundle/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (31)Versions (14)Used By (0)

Wallet QR Bundle
================

[](#wallet-qr-bundle)

[![CI](https://github.com/nowo-tech/WalletQrBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/WalletQrBundle/actions/workflows/ci.yml) [![Packagist Version](https://camo.githubusercontent.com/73612bb1ee5a8608bc34bfc3b3722401ee550a73396a88e6ff5b2274944d72ab/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f77616c6c65742d71722d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/wallet-qr-bundle) [![Packagist Downloads](https://camo.githubusercontent.com/c740444508fbaa7e4b42d2e2a000d39ba13df96f7165451b1260499405e91924/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f77616c6c65742d71722d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/wallet-qr-bundle) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) [![PHP](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)](https://php.net) [![Symfony](https://camo.githubusercontent.com/0701ae1a8855b98dea0f1dc9d9025d6b0f9444a803559dc983614d044176348b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d372e34253230253743253230382e30253230253743253230382e312532422d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com) [![GitHub stars](https://camo.githubusercontent.com/c7e5891b9ef00178dab3dcc83258b0e69f8fcc27ee8ea9604cc9a040b4f4773f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f77616c6c65742d71722d62756e646c652e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/WalletQrBundle) [![Coverage](https://camo.githubusercontent.com/cd0704b56f1d56def350b6d0164316307bb2f47834225fd85443b6fb0059bc73/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d3130302532352d627269676874677265656e)](#tests-and-coverage)

> ⭐ **Found this useful?** Give it a star on GitHub! It helps us maintain and improve the project. 📋 **Requires PHP 8.2+ and Symfony 7.x or 8.x** (CI matrix includes Symfony **7.4**, **8.0**, **8.1**)

**FrankenPHP demos:** runtime is selected with **`FRANKENPHP_MODE`** (`worker` default, or `classic` for per-request PHP / hot-reload). See [docs/DEMO-FRANKENPHP.md](docs/DEMO-FRANKENPHP.md). **Symfony bundle to generate Google Wallet (Android) and Apple Wallet (iOS) save links with QR codes.**

QR rendering requires the mandatory dependency [**QrCodeBundle**](https://github.com/nowo-tech/QrCodeBundle) (`nowo-tech/qr-code-bundle`), which Composer installs automatically. You can also use it standalone for QR codes outside wallet flows.

[![FrankenPHP Friendly Worker Mode](docs/images/frankenphp-friendly.png)](docs/images/frankenphp-friendly.png)

This bundle is **FrankenPHP worker mode friendly**.

Features
--------

[](#features)

- ✅ Google Wallet **Add to Google Wallet** save links (signed JWT)
- ✅ Apple Wallet `.pkpass` download URL builder for iOS QR codes
- ✅ PNG QR codes as data URIs via required [QrCodeBundle](https://github.com/nowo-tech/QrCodeBundle) (Twig helpers included)
- ✅ Pair generation for Android + iOS in one call
- ✅ Symfony configuration under `nowo_wallet_qr`
- ✅ URL validation for custom QR links (`QrUrlPolicy`; optional host allowlist)
- ✅ Demo apps for Symfony 7 and 8 (FrankenPHP)

Quick start
-----------

[](#quick-start)

```
composer require nowo-tech/wallet-qr-bundle
```

`nowo-tech/qr-code-bundle` is pulled in as a **required** dependency. Register both bundles (Flex does this via the recipe):

```
Nowo\QrCodeBundle\NowoQrCodeBundle::class => ['all' => true],
Nowo\WalletQrBundle\NowoWalletQrBundle::class => ['all' => true],
```

```
# config/packages/nowo_wallet_qr.yaml
nowo_wallet_qr:
    google_wallet:
        enabled: true
        issuer_id: '%env(GOOGLE_WALLET_ISSUER_ID)%'
        service_account_json: '%kernel.project_dir%/config/google-wallet-service-account.json'
        origins: ['www.example.com']
    apple_wallet:
        enabled: true
        pass_download_url_pattern: 'https://www.example.com/wallet/{pass_id}.pkpass'

# Prefer configuring QR options on QrCodeBundle (legacy nowo_wallet_qr.qr_code still works):
# config/packages/nowo_qr_code.yaml
nowo_qr_code:
    default_profile: default
    profiles:
        default:
            size: 300
```

```
use Nowo\WalletQrBundle\Model\GoogleWalletPassReference;
use Nowo\WalletQrBundle\Service\WalletQrService;

$reference = GoogleWalletPassReference::withIssuer(
    $issuerId,
    objectSuffix: 'MEMBER_001',
    classSuffix: 'MEMBER_CLASS',
);

$pair = $walletQrService->createWalletQrPair($reference, applePassId: 'MEMBER_001');
// $pair['android']->qrCodeDataUri, $pair['ios']->qrCodeDataUri
```

Development
-----------

[](#development)

```
make up
make test
make test-coverage
make demo-smoke
make release-check
```

Demos: `make -C demo/symfony8 up`

Documentation
-------------

[](#documentation)

- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [Contributing](docs/CONTRIBUTING.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Changelog](docs/CHANGELOG.md)
- [Upgrading](docs/UPGRADING.md)
- [Release](docs/RELEASE.md)
- [Security](docs/SECURITY.md)
- [Engram](docs/ENGRAM.md)
- [Spec-driven development](docs/SPEC-DRIVEN-DEVELOPMENT.md)
- [GitHub Spec Kit](docs/SPEC-KIT.md)

### Additional documentation

[](#additional-documentation)

- [GitHub Actions CI requirements](docs/GITHUB_CI.md)
- [Demo with FrankenPHP](docs/DEMO-FRANKENPHP.md)

Tests and coverage
------------------

[](#tests-and-coverage)

LanguageCoveragePHP~100% linesRun `make test-coverage` for the detailed report.

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance97

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 56.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~5 days

Total

11

Last Release

16d ago

Major Versions

v1.1.0 → v2.0.02026-06-30

v2.1.5 → v3.0.02026-07-30

PHP version history (2 changes)v1.0.0PHP &gt;=8.1 &lt;8.6

v2.0.0PHP &gt;=8.2 &lt;8.6

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7947bfc3f2ce9574a18a2c60f3d95b5d1b0740e65dc929332c92f1df21f75ab?d=identicon)[HecFranco](/maintainers/HecFranco)

---

Top Contributors

[![HecFranco](https://avatars.githubusercontent.com/u/24323276?v=4)](https://github.com/HecFranco "HecFranco (22 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (13 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (4 commits)")

---

Tags

apple-walletfrankenphpgoogle-walletphpqr-codesymfonysymfony-bundlewalletphpqr codesymfonymobilefrankenphpandroidwalletSymfony Bundleiosgoogle walletapple wallet

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nowo-tech-wallet-qr-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/nowo-tech-wallet-qr-bundle/health.svg)](https://phpackages.com/packages/nowo-tech-wallet-qr-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.3M418](/packages/easycorp-easyadmin-bundle)[chameleon-system/chameleon-base

The Chameleon System core.

1029.4k6](/packages/chameleon-system-chameleon-base)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1617.3k16](/packages/2lenet-crudit-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
