Skip to content
Entwickler

Wallet-Karten-API

Eine einheitliche API zum Erstellen, Aktualisieren und Sperren von Apple Wallet- und Google Wallet-Karten mit Webhooks für Echtzeit-Ereignisse.

  • REST-API & Webhooks
  • Apple Wallet + Google Wallet
  • Vorlagen, Batch & Sandbox
Kompatibel mit:
Apple WalletApple WalletGoogle WalletGoogle Wallet

Passinstance REST-API-Explorer

Illustratives Beispiel

Beispielanfragen und -antworten. Es wird kein API-Aufruf gesendet.

POST/api/v1/passes
Stellen Sie eine personalisierte Karte für Apple Wallet und Google Wallet mit direkten Download-Links aus.
curl -X POST https://api.passinstance.com/api/v1/passes \
  -H "X-API-Key: $PASSINSTANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "customFields": {
      "customerName": { "label": "MEMBER", "value": "Jane Doe" },
      "pointsBalance": { "label": "POINTS", "value": "1,450 pts" },
      "tier": { "label": "TIER", "value": "Gold VIP" }
    },
    "barcodeMessage": "PASS-MEM-2026-8819"
  }'
Beispielantwort
201 Created
{
  "ok": true,
  "data": {
    "id": "pass_9842011a",
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "status": "active",
    "downloadUrl": "https://api.passinstance.com/api/v1/passes/pass_9842011a/download",
    "googleWalletUrl": "https://pay.google.com/gp/v/save/eyJhbGciOiJSUzI1...",
    "applePassUrl": "https://passinstance.com/p/pass_9842011a.pkpass",
    "createdAt": "2026-08-16T15:25:00Z"
  }
}
Übersicht

Passinstance bietet eine Wallet-Karten-API, mit der Entwicklerteams den gesamten Kartenlebenszyklus automatisieren: Vorlagenerstellung, dynamische Feldaktualisierungen, Push-Nachrichten und Entwertungen über eine einzige Schnittstelle.

Webhooks informieren Ihre Backend-Systeme, CRM oder Kassen in Echtzeit über Installationen, Updates und Scans.

Funktionen

Alles für den produktiven Einsatz Ihrer Wallet-Karten

01

Karten-Lebenszyklus-Endpunkte

Erstellen, lesen, aktualisieren und sperren Sie Karten mit zuverlässigen REST-Endpunkten.

02

Webhooks für Karten-Ereignisse

Empfangen Sie Echtzeit-Events für Installationen, Änderungen und Entwertungen.

03

Wallet-Karten-API

Erstellen, aktualisieren und sperren Sie Karten programmatisch per REST-API und Echtzeit-Webhooks.

04

QR-Codes und Download-Links

Verteilen Sie Karten über gehostete Hinzufügen-Seiten, QR-Codes, E-Mail, SMS oder an der Kasse — ohne App-Download.

05

Wallet-spezifische Kartenupdates

Aktualisieren Sie Kartendaten per API. Apple Wallet kann konfigurierte Änderungshinweise anzeigen; integrierte Google-Wallet-Hinweise steuert Google.

06

Standortrelevanz

Hinterlegen Sie relevante Standorte für unterstützte Wallet-Funktionen. Verfügbarkeit, Anzeigezeitpunkt und Berechtigungen hängen von Wallet und Kundeneinstellungen ab.

07

Gültigkeit, Ablauf & Lebenszyklus

Steuern Sie Ablaufdaten, verlängern Sie Gültigkeiten beim Scan und verwalten Sie den gesamten Karten-Lebenszyklus.

FAQ

Häufig gestellte Fragen

Was bietet die Wallet-Karten-API?

Erstellen, aktualisieren und sperren Sie Apple-Wallet- und Google-Wallet-Pässe per API. Apple-Wallet-Updates nutzen APNs; integrierte Google-Wallet-Hinweise steuert Google. Die API bietet außerdem Vorlagen und Webhooks für Passereignisse.

Gibt es eine gemeinsame API für beide Plattformen?

Ja. Ein einziger Aufruf erzeugt und aktualisiert Karten für iOS und Android.

Werden Webhooks unterstützt?

Ja. Alle Karten-Events werden in Echtzeit an Ihre Endpunkte übertragen.

Gibt es eine Sandbox-Umgebung?

Ja. Testumgebungen und Test-API-Schlüssel stehen zur Verfügung.

ECHTE PRODUKTIONSPÄSSE AUF DEM SMARTPHONE TESTEN

Echte Pässe direkt in Apple Wallet & Google Wallet scannen

Halten Sie Ihre Smartphone-Kamera auf einen beliebigen QR-Code unten, um sofort einen verifizierten Produktionspass zu installieren. Erleben Sie Sperrbildschirm-Benachrichtigungen und native Wallet-Integration ohne App-Download.

Apple WalletGoogle WalletApple Wallet & Google Wallet
Private Banking
Aurelia Private Bank - Private Client Cashback & Concierge
Live-Erlebnis

Live-Pass der Aurelia Privatbank testen

Zeigen Sie Cashback in Echtzeit und den Concierge-Status rund um die Uhr in der Filiale oder am POS – ganz ohne separate Banking-App.

KundeAlexander Wright
Cashback€428.50
Konto•••• 9104

Interaktive Demo-Pässe für Apple Wallet und Google Wallet

Dieses Wallet-Erlebnis in Ihrem Workspace erstellen

Starten Sie kostenlos mit übernommenem Demo-Kontext, sodass Ihnen beim Onboarding direkt die passende Vorlage angeboten wird.

Mit der Wallet-Karten-API starten

Kostenlos registrieren, API-Keys erhalten und Kartenausgabe mit Webhooks automatisieren.