Apple-Wallet-Pass-API
Lass Nutzer .pkpass-Pässe (Tickets, Coupons, Mitgliedskarten) aus deiner Web-App zu Apple Wallet hinzufügen.
Mit der Apple-Wallet-Pass-API kann deine Web-App eine .pkpass-Datei (Event-Ticket, Bordkarte, Coupon, Kunden- oder Mitgliedskarte) an den Nutzer übergeben, damit er sie zu Apple Wallet hinzufügen kann.
Verwendung:
Verlinke deine .pkpass-Datei, ersetze dabei jedoch das https://-Präfix der Datei-URL durch addpkpass://:
<a href="addpkpass://example.com/passes/ticket.pkpass">Ticket zu Apple Wallet hinzufügen</a>
So funktioniert es:
- Die App wandelt den
addpkpass://-Link zurück in einehttps://-URL um. - Die Pass-URL wird in einem In-App-Browser-Tab geöffnet, der den
.pkpass-Inhalt erkennt und die native Zu Apple Wallet hinzufügen-Vorschau anzeigt. - Der Nutzer bestätigt, und der Pass wird in der Wallet-App gespeichert.
Hinweise: Der Pass muss über HTTPS mit dem korrekten MIME-Type application/vnd.apple.pkpass ausgeliefert und mit einem gültigen Apple-Pass-Type-ID-Zertifikat signiert sein (siehe die Apple-Wallet-Passes-Dokumentation zur Erstellung von Pässen).
Implementierungshinweise im SDK-Stil
Betrachte diese Funktion als native Fähigkeit, die deiner Web-Ebene bereitgestellt wird: Behalte deine Produktivwebsite oder PWA als zentrale Quelle bei und nutze anschließend die dokumentierten WebViewGold-Konfigurationsflags, URL-Befehle und JavaScript-Bridge-Aufrufe, um natives iOS-Verhalten nur dort zu aktivieren, wo es einen Mehrwert bietet. So bleibt deine Codebasis wartbar, da dieselbe Webanwendung mit minimaler Fallunterscheidung Browser, WebViewGold für iOS und die übrigen WebViewGold-Plattformen bedienen kann.
Für zuverlässige Ergebnisse empfehlen sich HTTPS-Endpunkte, stabile Routennamen, explizite Erfolgs-/Fehlerzustände in deiner UI sowie kleine JavaScript-Hilfsfunktionen, die native Aufrufe kapseln. Beispielsweise kann eine mit jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, einem eigenen React-/Vue-/Angular-Stack oder statischem HTML erstellte Web-App eine einzelne Schaltfläche oder einen Event-Handler bereitstellen, der die native WebViewGold-API auslöst und dennoch einen sauberen Browser-Fallback zeigt.
- Empfohlenes Integrationsmuster: Erkenne den App-Kontext, rufe die WebViewGold-API auf und aktualisiere anschließend deine Web-UI nach dem nativen Callback oder Routenwechsel.
- Test-Checkliste: Prüfe die Funktion auf einem echten Gerät oder in einem paketierten Build, überprüfe Berechtigungen und Store-Prüftexte und stelle sicher, dass reine Browser-Nutzer weiterhin einen sinnvollen Fallback erhalten.
- SEO-Vorteil: Halte Feature-Seiten, Routentitel und strukturierte Inhalte auf deiner Website indexierbar, während WebViewGold die native App-Hülle für iOS-Nutzer bereitstellt.