mhinspeya / inspeya-hyva-qrloginviaapp

1.0.0 2026-10-27 13:59 UTC

Requires

• php: ~8.3.0||~8.4.0
• magento/framework: 103.0.*
• magento/module-customer: 103.0.*
• mhinspeya/backend-mod: ^1.0

Suggests

• mhinspeya/backend-mod: Support Configuration

OSL-3.0

• MHinspeya

• login
• qr
• magento
• magento2
• mobile-app
• hyva
• MHinspeya
• qr-login

Published on Packagist.org on 2026-10-27 14:02 UTC

README

Customers sign in on the Magento website by scanning a QR code with the shop app. The website shows the code, the app confirms the email, and Magento opens the customer session. If the email exists only in the app, the app can create the shop account after an email confirmation code.

Module	MHinspeya_AppQrLogin
Package	mhinspeya/inspeya-hyva-qrloginviaapp
Version	1.0.0
Platform	Magento 2.4 + Hyvä
License	OSL-3.0

Features

Storefront

• Login via App tab on the Hyvä customer login page, beside email and password
• QR popup with countdown, status text, and cancel
• Optional Login via App step for guests on checkout
• New shop accounts use the configured customer group, after an email confirmation code

Admin

• Enable the login page and checkout independently
• Request lifetime (seconds) and how often the page checks the app (milliseconds)
• Android and iPhone app identity so the camera opens the installed app
• App Store and Play Store URLs when the app is not installed
• In-admin Documentation buttons (Overview, Installation, User Guide)

Integration

• QR address on this shop: /open
• Phone verification files: /.well-known/assetlinks.json and /.well-known/apple-app-site-association
• REST API for the shop app (/rest/V1/applogin-qr/…)

Requirements

• Magento Open Source or Adobe Commerce 2.4
• Hyvä theme (customer login tab)
• mhinspeya/backend-mod ^1.0
• PHP 8.3 or 8.4
• Store email that can send the registration confirmation code
• HTTPS on the public shop domain (required for the phone to open the app from the QR code)

Installation

Composer

composer require mhinspeya/inspeya-hyva-qrloginviaapp
bin/magento module:enable MHinspeya_AppQrLogin
bin/magento setup:upgrade
bin/magento cache:flush

Package path after install: vendor/mhinspeya/inspeya-hyva-qrloginviaapp.

Manual

1. Place the module under app/code/MHinspeya/AppQrLogin (or use the Composer package layout).
2. Ensure mhinspeya/backend-mod is installed.
3. Run:

bin/magento module:enable MHinspeya_AppQrLogin
bin/magento setup:upgrade
bin/magento cache:flush

Production

bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f en_US de_DE de_AT de_CH
bin/magento cache:flush

Confirm with:

bin/magento module:status MHinspeya_AppQrLogin

Configuration

Stores → Configuration → MHinspeya.de → App Login
(also Inspeya → App Login → Konfiguration)

Area	Settings
Login	Enable on the customer login page, enable on checkout
Timing	Request TTL in seconds, storefront poll interval in milliseconds
Accounts	Register customer group
App links	App base URL, Android package and SHA-256, iOS Team ID, bundle ID, URL scheme, store URLs
Documentation	Opens Overview, Installation Guide, User Guide

Storefront routes

Page	Typical path
Customer login	/customer/account/login/
QR landing (camera)	/open
Create QR	POST /fbemail/qr/create
Poll status	POST /fbemail/qr/poll
Cancel	POST /fbemail/qr/cancel

Admin menu

Inspeya → App Login

• Konfiguration

Documentation

Full guides with screenshots live in docs/:

Document	HTML	PDF
Module Overview	docs/01-Module-Overview.html	docs/01-Module-Overview.pdf
Installation Guide	docs/02-Installation-Guide.html	docs/02-Installation-Guide.pdf
User Guide	docs/03-User-Guide.html	docs/03-User-Guide.pdf

Also available as docs/MHinspeya-LoginViaApp-Overview.pdf, docs/MHinspeya-LoginViaApp-Installation.pdf, and docs/MHinspeya-LoginViaApp-Guide.pdf.

In admin, Documentation has View … (HTML) and Download … PDF buttons.

App integration details: docs/API-QR-LOGIN.md.

REST API (shop app)

Endpoints are registered in etc/webapi.xml under /rest/V1/applogin-qr/….

Method	Path	Purpose
POST	/applogin-qr/validate/	Validate the scanned code and email
POST	/applogin-qr/check-account/	Check whether the shop account exists
POST	/applogin-qr/send-otp/	Email the registration confirmation code
POST	/applogin-qr/verify-otp/	Check that confirmation code
POST	/applogin-qr/register/	Create the shop account
POST	/applogin-qr/approve/	Approve the login (customer token)
POST	/applogin-qr/reject/	Reject the login (customer token)

Approve and reject use the customer Bearer token from POST /V1/firebase-email/getFirebaseEmail/. The token email must match the email on the QR request.

Support

Support and inquiries: inspeya.com

License

Open Software License 3.0.