Skip to content
Guida del Centro assistenza · Sicurezza e conformità
3 min di letturaVerificato 2026-11-16

Privacy dei dati e GDPR

Configura modelli in Privacy Mode, tracciamento consensi, pulizia visite non reclamate ed eliminazione dati.

In questa guida

Governance Privacy-by-Design e conformità al GDPR

Passinstance consente alle organizzazioni europee e globali di gestire programmi fedeltà, biglietteria e affiliazione su portafogli digitali nel rigoroso rispetto del Regolamento generale sulla protezione dei dati dell'UE (GDPR) e del CCPA. Attraverso Privacy Compliance API (/api/v1/customer/:customerId/privacy-settings/*) e nella Dashboard in Impostazioni del workspace -> Privacy (/settings/workspace/privacy), i workspace possono applicare la minimizzazione dei dati, automatizzare l'eliminazione per scadenza dei termini di conservazione (RETENTION_POLICY_KEYS) ed eseguire flussi di lavoro verificabili per i diritti degli interessati (DSR).

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
CONSERVAZIONE GDPR E DIRITTI DEGLI INTERESSATI (DSR)
FASE 01 MOTORE DI CONSERVAZIONE AUTOMATIZZATA (/customer/:customerId/privacy-settings/retention)
Criteri (RETENTION_POLICY_KEYS): neverWalletAddedPasses, passesWithoutActiveWalletRegistrations, passesByCreationAge, expiredPasses, passesNotModifiedSince, emailDeliveryRecords, smsDeliveryRecords
Anteprima: POST.../retention/:policyKey/preview
Esecuzione: POST.../retention/:policyKey/run?dryRun=true|false
FASE 02 PIPELINE DEI DIRITTI DEGLI INTERESSATI (DSR) (/customer/:customerId/privacy-settings)
1
Ricerca (POST.../data-subject-search): { query }risultati raggrupp.
2
Portabilità (POST.../data-subject-export): { query }archivio JSON
3
Cancellazione (POST.../data-subject-delete): { query, confirmationPhrase, reason, requestVerified: true }IDataSubjectDeletionSummary

Riferimento API per la privacy e la conservazione dei dati (Privacy Compliance API)

Tutti gli endpoint relativi a privacy, conservazione dei dati e diritti degli interessati GDPR sono isolati a livello di tenant sotto /api/v1/customer/:customerId/privacy-settings:

Percorso EndpointMetodoAutenticazioneFunzionalità
/api/v1/customer/:customerId/privacy-settingsGETBearerRecupera le impostazioni generali di tracciamento, legali e sulla privacy del workspace.
/api/v1/customer/:customerId/privacy-settings/retentionGET / PATCHBearerElenca o aggiorna (request payload) i criteri di conservazione indicizzati tramite RETENTION_POLICY_KEYS.
/api/v1/customer/:customerId/privacy-settings/retention/activityGETBearerElenca le esecuzioni recenti, pianificate e manuali, dei criteri di conservazione (RetentionRunStatus: `SCHEDULEDRUNNINGCOMPLETEDCOMPLETED_WITH_WARNINGSFAILEDCANCELLED`).
/api/v1/customer/:customerId/privacy-settings/retention/:policyKey/previewPOSTBearerEsegue una simulazione non distruttiva restituendo il conteggio esatto dei record idonei per :policyKey.
/api/v1/customer/:customerId/privacy-settings/retention/:policyKey/runPOSTBearerEsegue immediatamente il criterio (supporta ?dryRun=true).
/api/v1/customer/:customerId/privacy-settings/data-subject-searchPOSTBearerCerca pass, record di recapito e scansioni tramite { query } (3–256 caratteri, corrispondenti a email, telefono, seriale o externalId).
/api/v1/customer/:customerId/privacy-settings/data-subject-exportPOSTBearerGenera un archivio JSON IDataSubjectExportPayload conforme agli articoli 15/20 del GDPR per { query }.
/api/v1/customer/:customerId/privacy-settings/data-subject-deletePOSTBearerEsegue l'anonimizzazione o la cancellazione ai sensi dell'articolo 17 del GDPR (request payload).

Criteri automatizzati di conservazione dei dati (RETENTION_POLICY_KEYS e RetentionAction)

Per applicare la limitazione della conservazione (articolo 5, paragrafo 1, lettera e) del GDPR), Privacy Compliance API definisce 7 chiavi di criteri canoniche (RETENTION_POLICY_KEYS):

  • Chiavi del ciclo di vita del pass: neverWalletAddedPasses, passesWithoutActiveWalletRegistrations, passesByCreationAge, expiredPasses, passesNotModifiedSince.
  • Chiavi dei log di recapito: emailDeliveryRecords, smsDeliveryRecords.

Ogni criterio configura enabled (boolean), retentionDays (da RETENTION_MIN_DAYS a RETENTION_MAX_DAYS, allineato alle preimpostazioni come DataRetentionPolicy: KEEP_FOREVER | DELETE_AFTER_30_DAYS | DELETE_AFTER_90_DAYS | DELETE_AFTER_1_YEAR | DELETE_AFTER_7_YEARS | CUSTOM) e 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"
    }
  }
}

Prima di eseguire un'eliminazione definitiva, chiami POST /api/v1/customer/:customerId/privacy-settings/retention/neverWalletAddedPasses/preview per ispezionare il numero di record interessati senza modificare i dati.

Esecuzione dei diritti degli interessati GDPR (request payload / request payload / request payload)

Quando un titolare di pass invia una richiesta di accesso dell'interessato (SAR) o una richiesta di diritto alla cancellazione:

  1. 1
    Individuazione dei record (POST .../data-subject-search): invii { "query": "customer@example.com" } (corrisponde anche a externalId, telefono o serialNumber) per restituire corrispondenze raggruppate IDataSubjectSearchResultGroup tra pass e log.
  2. 2
    Esportazione dell'archivio portabile (POST .../data-subject-export): invii { "query": "customer@example.com" } per ricevere IDataSubjectExportPayload ({ exportedAt, workspaceId, queryLength, groups, totalCount }).
  3. 3
    Cancellazione verificata (POST .../data-subject-delete): richiede { 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
}

Risposta (200 OK — IDataSubjectDeletionSummary):

JSON
{
  "passesAnonymized": 2,
  "deliveryRecordsDeleted": 6,
  "skippedProtected": 0
}

Importante: L'esecuzione della cancellazione lato server (POST .../data-subject-delete) anonimizza o elimina i dati personali nei database di Passinstance e rispetta i blocchi di conservazione attivi (retentionHoldUntil). Tuttavia, poiché Apple Wallet memorizza localmente i file .pkpass firmati sull'iPhone dell'utente, il titolare del pass deve comunque toccare Rimuovi biglietto all'interno di Apple Wallet per eliminare la carta memorizzata nella cache dal proprio dispositivo fisico.

Consulti i nostri impegni legali completi nell'Informativa sulla privacy e nel Centro sicurezza e fiducia.

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.