Privacy-by-Design-Governance & DSGVO-Compliance
Passinstance ermöglicht europäischen und globalen Organisationen den Betrieb von Treue-, Ticketing- und Mitgliedschaftsprogrammen für digitale Wallets unter strikter Einhaltung der Datenschutz-Grundverordnung (DSGVO / GDPR) der EU sowie des CCPA. Über den Privacy Compliance API (/api/v1/customer/:customerId/privacy-settings/*) und im Dashboard unter Workspace-Einstellungen -> Datenschutz (/settings/workspace/privacy) können Workspaces Datenminimierung durchsetzen, Aufbewahrungsbereinigungen (RETENTION_POLICY_KEYS) automatisieren und überprüfbare Workflows für Betroffenenrechte (Data Subject Rights, DSR) ausführen.
API-Referenz für Datenschutz & Datenaufbewahrung (Privacy Compliance API)
Alle Endpunkte für Datenschutz, Aufbewahrung und DSGVO-Betroffenenrechte sind mandantenbezogen unter /api/v1/customer/:customerId/privacy-settings angesiedelt:
| Endpunktpfad | Methode | Authentifizierung | Funktionalität | |||||
|---|---|---|---|---|---|---|---|---|
/api/v1/customer/:customerId/privacy-settings | GET | Bearer | Ruft die Tracking-, Rechts- und Datenschutz-Übersichtseinstellungen des Workspaces ab. | |||||
/api/v1/customer/:customerId/privacy-settings/retention | GET / PATCH | Bearer | Listet Aufbewahrungsrichtlinien anhand von RETENTION_POLICY_KEYS auf oder aktualisiert sie (request payload). | |||||
/api/v1/customer/:customerId/privacy-settings/retention/activity | GET | Bearer | Listet kürzlich geplante und manuelle Ausführungsläufe der Datenaufbewahrung auf (RetentionRunStatus: `SCHEDULED \ | RUNNING \ | COMPLETED \ | COMPLETED_WITH_WARNINGS \ | FAILED \ | CANCELLED`). |
/api/v1/customer/:customerId/privacy-settings/retention/:policyKey/preview | POST | Bearer | Führt einen nicht-destruktiven Testlauf durch und gibt die genaue Anzahl der betroffenen Datensätze für :policyKey zurück. | |||||
/api/v1/customer/:customerId/privacy-settings/retention/:policyKey/run | POST | Bearer | Führt die Richtlinie sofort aus (unterstützt ?dryRun=true). | |||||
/api/v1/customer/:customerId/privacy-settings/data-subject-search | POST | Bearer | Durchsucht Karten, Zustellprotokolle und Scans über { query } (3–256 Zeichen; gleicht E-Mail, Telefon, Seriennummer oder externalId ab). | |||||
/api/v1/customer/:customerId/privacy-settings/data-subject-export | POST | Bearer | Generiert ein IDataSubjectExportPayload-JSON-Archiv gemäß Art. 15/20 DSGVO für { query }. | |||||
/api/v1/customer/:customerId/privacy-settings/data-subject-delete | POST | Bearer | Führt die Anonymisierung bzw. Löschung gemäß Art. 17 DSGVO aus (request payload). |
Automatisierte Datenaufbewahrungsrichtlinien (RETENTION_POLICY_KEYS & RetentionAction)
Zur Durchsetzung der Speicherbegrenzung (Art. 5 Abs. 1 lit. e DSGVO) definiert der Privacy Compliance API 7 kanonische Richtlinienschlüssel (RETENTION_POLICY_KEYS):
-
Schlüssel für den Kartenlebenszyklus:
neverWalletAddedPasses,passesWithoutActiveWalletRegistrations,passesByCreationAge,expiredPasses,passesNotModifiedSince. -
Schlüssel für Zustellprotokolle:
emailDeliveryRecords,smsDeliveryRecords.
Jede Richtlinie konfiguriert enabled (boolean), retentionDays (RETENTION_MIN_DAYS bis RETENTION_MAX_DAYS, abgestimmt auf Voreinstellungen wie DataRetentionPolicy: KEEP_FOREVER | DELETE_AFTER_30_DAYS | DELETE_AFTER_90_DAYS | DELETE_AFTER_1_YEAR | DELETE_AFTER_7_YEARS | CUSTOM) sowie action (RetentionAction: 'delete' | 'anonymize'):
{
"policies": {
"neverWalletAddedPasses": {
"enabled": true,
"retentionDays": 30,
"action": "delete"
},
"expiredPasses": {
"enabled": true,
"retentionDays": 90,
"action": "anonymize"
},
"emailDeliveryRecords": {
"enabled": true,
"retentionDays": 365,
"action": "delete"
}
}
}
Rufen Sie vor dem Ausführen einer Bereinigung POST /api/v1/customer/:customerId/privacy-settings/retention/neverWalletAddedPasses/preview auf, um die Anzahl der betroffenen Datensätze zu prüfen, ohne Daten zu verändern.
Ausführen von DSGVO-Betroffenenrechten (request payload / request payload / request payload)
Wenn ein Karteninhaber einen Auskunftsantrag (SAR) oder einen Antrag auf Löschung („Recht auf Vergessenwerden“) stellt:
-
1
Datensätze ermitteln (
POST .../data-subject-search): Übermitteln Sie{ "query": "customer@example.com" }(findet auchexternalId, Telefonnummer oderserialNumber), um gruppierteIDataSubjectSearchResultGroup-Treffer über Karten und Protokolle hinweg zu erhalten. -
2
Portables Archiv exportieren (
POST .../data-subject-export): Übermitteln Sie{ "query": "customer@example.com" }, um dasIDataSubjectExportPayload({ exportedAt, workspaceId, queryLength, groups, totalCount }) zu erhalten. -
3
Verifizierte Löschung (
POST .../data-subject-delete): Erfordert{ query, confirmationPhrase: "DELETE PERSONAL DATA", reason, requestVerified: true, resourceIds? }:
{
"query": "customer@example.com",
"confirmationPhrase": "DELETE PERSONAL DATA",
"reason": "Verified GDPR Article 17 erasure request #DSR-4410",
"requestVerified": true
}
Antwort (200 OK — IDataSubjectDeletionSummary):
{
"passesAnonymized": 2,
"deliveryRecordsDeleted": 6,
"skippedProtected": 0
}
Wichtig: Die Ausführung einer serverseitigen Löschung (
POST .../data-subject-delete) anonymisiert bzw. löscht personenbezogene Daten in den Passinstance-Datenbanken und berücksichtigt aktive Aufbewahrungssperren (retentionHoldUntil). Da Apple Wallet signierte.pkpass-Dateien jedoch lokal auf dem iPhone des Nutzers speichert, muss der Karteninhaber in Apple Wallet weiterhin selbst auf Karte entfernen tippen, um die zwischengespeicherte Karte von seinem physischen Endgerät zu löschen.
Lesen Sie unsere vollständigen rechtlichen Verpflichtungen in der Datenschutzerklärung und im Sicherheits- & Trust-Center.
