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
PASSCREATOR_API_KEY— nur inapps/dashboard/.env.local(lokal) und Render (Dashboard). Nie in v0 oder ins Repo.- Pass Type ID / Zertifikat in Passcreator (manuell im Konto;
--pass-type-idoderPASSCREATOR_PASS_TYPE_ID). - 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
| Zweck | Pfad |
|---|---|
| Template-liste | GET 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
- Unit-Check (ohne API):
node --test scripts/passcreator-bootstrap-loop-master-template.test.mjs - Key gesetzt → Skript Dry-Run ohne Fehler, Template-Liste sichtbar (ggf. mit
--template-id). - Nach
--apply: UUID im Cockpit, Wallet aktivieren, PublicPOST …/loyalty/wallet/passmit Testkarte. - 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