README

⭐ Found this useful? Give it a star on GitHub! It helps us maintain and improve the project.

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

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

📋 Requires PHP 8.2+ and Symfony 7.4+ or 8.x (CI matrix includes Symfony 7.4, 8.0, 8.1)

This bundle is FrankenPHP worker mode friendly.

It stays safe when the kernel is not reset between requests — see docs/FRANKENPHP-WORKER-AUDIT.md.

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 (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

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

FrankenPHP demos: runtime is selected with FRANKENPHP_MODE (worker default, or classic for per-request PHP / hot-reload). See docs/DEMO-FRANKENPHP.md.

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

Demos: make -C demo/symfony8 up

Documentation

Additional documentation

Tests and coverage

Language	Coverage
PHP	~100% lines

Run make test-coverage for the detailed report.

License

MIT — see LICENSE.

nowo-tech / wallet-qr-bundle

Package info

Security

Fund package maintenance!

Statistics