Ein Link
<a href="addpkpass://yourdomain.com/passes/ticket-123.pkpass">: WebViewGold macht daraus wieder eine https://-URL und öffnet sie in einem In-App-Browser-Tab, der den Pass erkennt und die native Vorschau „Zu Apple Wallet hinzufügen“ zeigt.
So funktioniert „Zu Apple Wallet hinzufügen“ in der App
Du erstellst und signierst den Pass
Eine .pkpass-Datei ist ein signiertes Paket (pass.json, Bilder, ein Manifest und eine Signatur), erstellt mit deinem eigenen Pass-Type-ID-Zertifikat aus deinem Apple-Developer-Konto. Erzeuge sie auf deinem Server oder mit einem Pass-Dienst; WebViewGold übergibt sie an Wallet.
Richtig ausliefern
HTTPS, der MIME-Typ application/vnd.apple.pkpass und eine gültige Signatur. Stimmt einer der drei Punkte nicht, kann iOS die Vorschau nicht anzeigen, und der Nutzer sieht stattdessen einen Fehler.
Android: Google Wallet
Seit 2024 kann Google Wallet viele .pkpass-Dateien importieren, die Unterstützung schwankt aber je nach Gerät und Pass, und das Schema addpkpass:// gibt es nur auf iOS. Der verlässliche Weg auf Android ist ein Google-Wallet-Pass, erstellt mit der Google Wallet API und dem offiziellen Button „Zu Google Wallet hinzufügen“, der auf einen von deinem Server signierten Speicherlink auf pay.google.com verweist.
Prompt für Cursor
Füge das in Cursor ein, um die Web-App-Seite umzusetzen. Prüfe das Ergebnis, veröffentliche und teste dann in der WebViewGold-App.
Prompt für den Cursor-Agenten
Prompt für den Cursor-Agenten: Füge Wallet-Pässe für unsere Tickets hinzu. 1) Erstelle lib/wallet/apple.ts, das einen eventTicket-.pkpass baut und signiert (passkit-generator oder gleichwertig), mit Zertifikaten aus serverseitigen Umgebungsvariablen, inklusive serialNumber, einem QR-Barcode mit dem Ticketcode, relevantDate und optional webServiceURL. 2) Füge eine authentifizierte Route hinzu, die eine signierte, kurzlebige Download-URL ausstellt, und eine Download-Route, die das Token prüft und den Pass mit Content-Type application/vnd.apple.pkpass zurückgibt. 3) Schreib einen Test, der einen erzeugten Pass entpackt und prüft, ob die manifest.json jede Datei mit dem richtigen SHA-1-Hash auflistet. 4) Nutze in der Oberfläche Apples offizielles Badge: In der iOS-App (navigator.userAgent enthält unser WebViewGold-Token und iPhone oder iPad) verlinkst du auf die Download-URL, wobei https:// durch addpkpass:// ersetzt wird; Safari bekommt die https-URL. 5) Füge optional lib/wallet/google.ts hinzu, das ein Google-Wallet-Speicher-JWT signiert und für Android https://pay.google.com/gp/v/save/JWT zurückgibt. 6) Dokumentiere beide Abläufe und den BROWSER_BLACKLIST-Eintrag für pay.google.com in .cursor/rules.
Großartige Möglichkeit, eine Web-App in eine native App zu verwandeln! Schnelle Umsetzung und ein toller Weg, Apps in die App Stores zu bringen, ohne eine komplett native App entwickeln zu müssen!
Pässe, die zu Vibe-Coding-Apps passen
Apple Wallet kennt fünf Pass-Stile: Event-Ticket, Kundenkarte, Coupon, Bordkarte und generisch. Am häufigsten kommen diese vor:
Event-Tickets
Workshops, Meetups, Konzerte, Kurse. Ein QR-Code mit Ticket-ID, Datum und Ort und ein relevantes Datum, damit der Pass vor dem Event auf dem Sperrbildschirm erscheint.
Kunden- und Stempelkarten
Cafés, Salons, Fitnessstudios. Eine Kundenkarte mit der Mitgliedsnummer als Barcode und einem Punktestand, den du später aktualisieren kannst.
Coupons und Angebote
Ein Rabattcode, der an der Kasse gescannt oder beim Checkout gezeigt wird, mit einem Ablaufdatum, das Nutzer sehen.
Mitgliedschaft und Zutritt
Clubmitgliedschaften, Coworking-Zugang, VIP- oder Saisonpässe: Identifikation ist einer der Einsatzzwecke, die Apple ausdrücklich nennt.
Wallet-Pässe zu einer Cursor-App hinzufügen
Ein Tag für den ersten Pass-Typ; am längsten dauern die Zertifikate.
Pass Type ID und Zertifikat anlegen
Registriere in deinem Apple-Developer-Konto unter Certificates, Identifiers & Profiles eine Pass Type ID (zum Beispiel pass.com.yourcompany.tickets), erstelle das zugehörige Zertifikat und lade Apples WWDR-Zwischenzertifikat herunter. Beides gehört auf deinen Server, nie in den Client.
Pässe auf dem Server erzeugen
Eine Serverfunktion in Deine eigenen API-Routen oder Dienste baut die pass.json (Seriennummer, Barcode mit dem Ticketcode, relevantes Datum oder relevanter Ort) und signiert sie, zum Beispiel mit passkit-generator unter Node oder über eine gehostete Pass-API. Speichere die Seriennummer zur Bestellung.
Den Download mit einem Token schützen
Der In-App-Browser-Tab teilt nicht unbedingt die Login-Cookies der WebView, gib der Pass-URL also ein signiertes, kurzlebiges Token, statt dich auf die Login-Session zu verlassen.
Den Button einbauen
Nutze Apples offizielles Badge „Zu Apple Wallet hinzufügen“. In der iOS-App verlinkst du den Pass mit
addpkpass://; in Safari funktioniert der normale https-Link nativ; auf Android zeigst du den Google-Wallet-Button oder ein PDF-Ticket.Pässe aktuell halten (optional)
Ergänze
webServiceURLundauthenticationTokenin der pass.json und implementiere Apples Pass-Webservice; ändern sich Gate, Platz oder Punktestand, benachrichtigst du das Gerät per APNs, und Wallet lädt die neue Version.Auf einem echten iPhone testen
Füge einen Pass hinzu, öffne ihn vom Sperrbildschirm aus, probiere ein abgelaufenes Token und ein storniertes Ticket aus. Prüfe, dass sich der Barcode mit dem Lesegerät scannen lässt, das du am Einlass tatsächlich nutzt.
Ein Helper für alle Plattformen
Dein Server liefert beide URLs; die Seite wählt die richtige. YourAppToken ist der eigene User Agent aus Config.swift / Config.java.
javascript
var ua = navigator.userAgent;
var inApp = ua.indexOf("YourAppToken") !== -1;
var isIOS = /iPhone|iPad|iPod/.test(ua);
var isAndroid = /Android/.test(ua);
// pass = {
// pkpassUrl: "https://yourdomain.com/passes/T-1042.pkpass?t=SIGNED_TOKEN",
// googleSaveUrl: "https://pay.google.com/gp/v/save/SIGNED_JWT", // von deinem Server erzeugt
// pdfUrl: "https://yourdomain.com/tickets/T-1042.pdf"
// }
function walletLink(pass) {
if (isIOS && inApp) return pass.pkpassUrl.replace(/^https:\/\//, "addpkpass://");
if (isIOS) return pass.pkpassUrl; // Safari öffnet .pkpass nativ
if (isAndroid && pass.googleSaveUrl) return pass.googleSaveUrl;
return pass.pdfUrl; // Desktop und Fallback
}
document.getElementById("add-to-wallet").href = walletLink(window.currentPass);Android und Google Wallet
WebViewGold hat keine eigene Google-Wallet-API, und das Schema addpkpass:// gibt es nur auf iOS. Der Weg über das Web funktioniert gut:
- Leg in der Google Pay & Wallet Console ein Ausstellerkonto an, definiere eine Pass-Klasse (Event-Ticket, Treuekarte, Angebot oder generisch) und lass deinen Server ein JWT mit einem Dienstkonto signieren. Das Ergebnis ist ein Speicherlink auf pay.google.com.
- Öffne diesen Link außerhalb der WebView, wo der Nutzer bei Google angemeldet ist: Trag pay.google.com in
BROWSER_BLACKLISTin Config.java ein oder stell dem Linknewtab:voran und setzSPECIAL_LINK_HANDLING_OPTIONSauf 2 (Doku zum URL-Handling). - Nutze Googles offizielles Button-Design „Zu Google Wallet hinzufügen“ und halte dich an die Markenrichtlinien, genau wie du auf iOS Apples Badge verwendest.
- Aktuelle Google-Wallet-Versionen können auch .pkpass-Dateien importieren, sieh das aber als Bonus, den du auf deinen Zielgeräten testest, nicht als Plan: In der App gibt es auf Android keine Wallet-Verarbeitung für .pkpass-Links.
- Halte immer einen Fallback bereit: Ein PDF-Ticket oder der QR-Code auf dem Bildschirm funktioniert auf jedem Gerät.
Häufig gestellte Fragen
Erstellt WebViewGold den Wallet-Pass für mich?
Nein. WebViewGold übergibt einen Pass an Apple Wallet. Erstellt und signiert wird die .pkpass-Datei auf deinem Server oder in einem Pass-Dienst, mit deinem eigenen Pass-Type-ID-Zertifikat aus dem Apple Developer Program.
Funktioniert „Zu Apple Wallet hinzufügen“ auf Android?
Apple Wallet gibt es nur auf Apple-Geräten. Google Wallet kann auf aktuellen Android-Smartphones viele .pkpass-Dateien importieren, die Unterstützung schwankt aber, deshalb ist der verlässliche Weg ein Google-Wallet-Pass über die Google Wallet API, dessen Speicherlink außerhalb der WebView geöffnet wird (BROWSER_BLACKLIST in Config.java), wo der Nutzer bei Google angemeldet ist. WebViewGold hat keine eigene Google-Wallet-API.
Kann ich einen Pass aktualisieren, nachdem der Nutzer ihn hinzugefügt hat?
Ja, mit Apples Pass-Webservice: Nimm webServiceURL und authenticationToken in die pass.json auf, dann registriert Wallet das Gerät bei deinem Server. Ändern sich Gate, Platz oder Guthaben, schickst du einen Push über APNs, und Wallet holt die neue Version.
Warum öffnet sich der Pass in einem In-App-Browser-Tab?
Dieser Tab erkennt den Content-Type von .pkpass und zeigt die native Vorschau „Zu Apple Wallet hinzufügen“. Er teilt nicht unbedingt die Cookies der Haupt-WebView, die Pass-URL muss also ohne die Login-Session der App funktionieren, zum Beispiel mit einem signierten, ablaufenden Token.
Können Nutzer Pässe auch über die Website hinzufügen?
Ja. Safari auf iPhone und Mac öffnet .pkpass-Links nativ, dieselbe https-URL funktioniert also im Web; nur die App nutzt das Präfix addpkpass://.
Drei Wege, deine App in die Stores zu bringen
Gleiches Ergebnis, unterschiedlich viel Arbeit auf deiner Seite. Alle drei kommen mit Genehmigungsgarantie und 24/7 Support von echten Menschen.
Selbst machen
$109 pro Plattform, einmalig
Die WebViewGold-Lizenz: ein fertiges Xcode- oder Android-Studio-Projekt. URL einfügen, Name und Icon setzen, Features einschalten, bauen und einreichen. Kostenlose Updates für immer.
Pakete auf der Hauptseite ansehenCloud Builder
$349 pro Lizenz, einmaliges Add-on
Kein Mac, kein Xcode, kein Android Studio: Du konfigurierst im Browser, wir bauen beide Apps in der Cloud und übergeben sie an App Store Connect und die Play Console.
So funktioniert der Cloud Builder Kostenlose Demo ausprobierenFull Service
$698 pro Plattform $798
Schick uns deine URL und dein Icon. Unser Team konfiguriert, baut und liefert deine App innerhalb von 72 Stunden, White-Label, inklusive Quellprojekten. Beide Plattformen für $1,158.
Full-Service-Details Powered by
Winter-Sale-Preise gültig bis 31. Dezember 2026.