Skip to main content

LOOP Wallet — Passcreator-Master-Template einrichten

Was​

Ein Skript legt das eine Passcreator-Template für LOOP an oder ergänzt ein vorhandenes: scripts/passcreator-bootstrap-loop-master-template.mjs. Es gibt am Ende die Template-UUID aus, die im Cockpit unter Dashboard → LOOP → Wallet als Passcreator-Template eingetragen wird.

Dynamische Felder (Platzhalter {name}) müssen zu buildWalletTemplateFields in loyalty-wallet-rules.ts passen: centerName, cardNumber, pointsBalance, storedValue, optional centerSlug.

Voraussetzungen​

  1. PASSCREATOR_API_KEY — nur in apps/dashboard/.env.local (lokal) und Render (Dashboard). Nie in v0 oder ins Repo.
  2. Pass Type ID / Zertifikat in Passcreator (manuell im Konto; --pass-type-id oder PASSCREATOR_PASS_TYPE_ID).
  3. Icon-URL (--icon-url / PASSCREATOR_ICON_URL) oder Platzhalter-Icon vom Skript.

Ablauf​

# Dry-Run (nur GET /api/pass-template + describe)
node scripts/passcreator-bootstrap-loop-master-template.mjs

# Bestehendes Master-Template per UUID (empfohlen, wenn der Name in Passcreator abweicht)
# PASSCREATOR_TEMPLATE_ID=<uuid> ist gleichwertig zu --template-id
node scripts/passcreator-bootstrap-loop-master-template.mjs \
--template-id 5824dffb-6552-4036-9713-a49a12cd6761

# Felder/Barcode auf dem bekannten Template ersetzen (Schreiben nur mit --apply)
node scripts/passcreator-bootstrap-loop-master-template.mjs --apply --force-fields \
--template-id 5824dffb-6552-4036-9713-a49a12cd6761

# Demo-Metadaten (logoText „DEMO PASS“, graue Template-Farben) entfernen und pro-Pass-Logo/Farben aktivieren
node scripts/passcreator-bootstrap-loop-master-template.mjs --apply --apply-pilot-branding \
--template-id 5824dffb-6552-4036-9713-a49a12cd6761

# Neues Template anlegen (nur wenn keine passende UUID existiert)
node scripts/passcreator-bootstrap-loop-master-template.mjs --apply --create-new \
--pass-type-id pass.de.example.loop --icon-url https://example.com/icon.png

Mit --template-id sucht das Skript nicht per --name, sondern liest/aktualisiert genau diese UUID (describe + ggf. Update). Ein neues Template wird dabei nicht angelegt — nur mit --create-new (dann wird --template-id für das Anlegen ignoriert).

Stehen --template-id und --name gleichzeitig, gilt die UUID als Ziel; --name dient nur noch als Anzeige-Fallback, wenn die UUID nicht in der Template-Liste steht.

Template-UUID im Cockpit unter LOOP → Wallet eintragen oder AgencyOS PATCH …/loyalty/wallet-config mit passcreatorTemplateId.

Optional: --apply --patch-center <centerId> (benötigt COCKPIT_AGENCYOS_API_KEY).

Passcreator-API-Hinweis​

ZweckPfad
Template-listeGET https://app.passcreator.com/api/pass-template
Anlegen / ändern / describe / publish/api/v2/pass-template…
Pass ausstellen (Cockpit-Laufzeit)POST /api/v3/pass

GET /api/v2/pass-template liefert 404 HTML — das ist kein ungültiger API-Key. Das Dashboard-Health (GET /api/integrations/passcreator/health) nutzt die Listing-Route.

So testen​

  1. Unit-Check (ohne API): node --test scripts/passcreator-bootstrap-loop-master-template.test.mjs
  2. Key gesetzt → Skript Dry-Run ohne Fehler, Template-Liste sichtbar (ggf. mit --template-id).
  3. Nach --apply: UUID im Cockpit, Wallet aktivieren, Public POST …/loyalty/wallet/pass mit Testkarte.
  4. Health mit Admin-Session: GET /api/integrations/passcreator/health → success: true.

Weiterer API-Vertrag: LOOP Loyalty — API-Vertrag.

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/developer-guide/loop-passcreator-bootstrap