Skip to content
Hilfecenter-Anleitung · Sicherheit & Compliance
3 Min. LesezeitGeprüft 2026-11-16

Datenschutz & DSGVO

Nutzen Sie Datenschutzmodus-Vorlagen, Einwilligungsprotokolle, Bereinigung nicht beanspruchter Besuche und Löschprozesse.

In dieser Anleitung

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.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
DSGVO-AUFBEWAHRUNG & BETROFFENENRECHTE (DSR)
STUFE 01 AUTOMATISIERTE AUFBEWAHRUNGS-ENGINE (/customer/:customerId/privacy-settings/retention)
Richtlinien (RETENTION_POLICY_KEYS): neverWalletAddedPasses, passesWithoutActiveWalletRegistrations, passesByCreationAge, expiredPasses, passesNotModifiedSince, emailDeliveryRecords, smsDeliveryRecords
Vorschau: POST.../retention/:policyKey/preview
Ausführung: POST.../retention/:policyKey/run?dryRun=true|false
STUFE 02 PIPELINE FÜR BETROFFENENRECHTE (DSR) (/customer/:customerId/privacy-settings)
1
Ermittlung (POST.../data-subject-search): { query }Treffergruppen
2
Übertragbarkeit (POST.../data-subject-export): { query }JSON-Archiv
3
Löschung (POST.../data-subject-delete): { query, confirmationPhrase, reason, requestVerified: true }IDataSubjectDeletionSummary

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:

EndpunktpfadMethodeAuthentifizierungFunktionalität
/api/v1/customer/:customerId/privacy-settingsGETBearerRuft die Tracking-, Rechts- und Datenschutz-Übersichtseinstellungen des Workspaces ab.
/api/v1/customer/:customerId/privacy-settings/retentionGET / PATCHBearerListet Aufbewahrungsrichtlinien anhand von RETENTION_POLICY_KEYS auf oder aktualisiert sie (request payload).
/api/v1/customer/:customerId/privacy-settings/retention/activityGETBearerListet 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/previewPOSTBearerFü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/runPOSTBearerFührt die Richtlinie sofort aus (unterstützt ?dryRun=true).
/api/v1/customer/:customerId/privacy-settings/data-subject-searchPOSTBearerDurchsucht 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-exportPOSTBearerGeneriert ein IDataSubjectExportPayload-JSON-Archiv gemäß Art. 15/20 DSGVO für { query }.
/api/v1/customer/:customerId/privacy-settings/data-subject-deletePOSTBearerFü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'):

JSON
{
  "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. 1
    Datensätze ermitteln (POST .../data-subject-search): Übermitteln Sie { "query": "customer@example.com" } (findet auch externalId, Telefonnummer oder serialNumber), um gruppierte IDataSubjectSearchResultGroup-Treffer über Karten und Protokolle hinweg zu erhalten.
  2. 2
    Portables Archiv exportieren (POST .../data-subject-export): Übermitteln Sie { "query": "customer@example.com" }, um das IDataSubjectExportPayload ({ exportedAt, workspaceId, queryLength, groups, totalCount }) zu erhalten.
  3. 3
    Verifizierte Löschung (POST .../data-subject-delete): Erfordert { query, confirmationPhrase: "DELETE PERSONAL DATA", reason, requestVerified: true, resourceIds? }:
JSON
{
  "query": "customer@example.com",
  "confirmationPhrase": "DELETE PERSONAL DATA",
  "reason": "Verified GDPR Article 17 erasure request #DSR-4410",
  "requestVerified": true
}

Antwort (200 OK — IDataSubjectDeletionSummary):

JSON
{
  "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.

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.