Governação de Privacidade desde a Conceção e Conformidade com o RGPD
O Passinstance permite às organizações europeias e globais operar programas de fidelização, bilhética e cartões de membro em carteiras digitais em estrita conformidade com o Regulamento Geral sobre a Proteção de Dados (RGPD) da UE e a CCPA. Através de Privacy Compliance API (/api/v1/customer/:customerId/privacy-settings/*) e no Painel de Controlo em Definições do Espaço de Trabalho -> Privacidade (/settings/workspace/privacy), os espaços de trabalho podem impor a minimização de dados, automatizar a limpeza por retenção (RETENTION_POLICY_KEYS) e executar fluxos de trabalho verificáveis de Direitos dos Titulares dos Dados (DSR).
Referência da API de Privacidade e Retenção de Dados (Privacy Compliance API)
Todos os endpoints de privacidade, retenção e Direitos dos Titulares dos Dados do RGPD estão delimitados ao tenant sob /api/v1/customer/:customerId/privacy-settings:
| Caminho do Endpoint | Método | Autenticação | Funcionalidade | |||||
|---|---|---|---|---|---|---|---|---|
/api/v1/customer/:customerId/privacy-settings | GET | Bearer | Obtém as definições gerais de rastreio, aspetos legais e privacidade do espaço de trabalho. | |||||
/api/v1/customer/:customerId/privacy-settings/retention | GET / PATCH | Bearer | Lista ou atualiza (request payload) as políticas de retenção indexadas por RETENTION_POLICY_KEYS. | |||||
/api/v1/customer/:customerId/privacy-settings/retention/activity | GET | Bearer | Lista as execuções recentes agendadas e manuais de retenção (RetentionRunStatus: `SCHEDULED | RUNNING | COMPLETED | COMPLETED_WITH_WARNINGS | FAILED | CANCELLED`). |
/api/v1/customer/:customerId/privacy-settings/retention/:policyKey/preview | POST | Bearer | Executa uma simulação não destrutiva que devolve a contagem exata de registos elegíveis para :policyKey. | |||||
/api/v1/customer/:customerId/privacy-settings/retention/:policyKey/run | POST | Bearer | Executa a política imediatamente (suporta ?dryRun=true). | |||||
/api/v1/customer/:customerId/privacy-settings/data-subject-search | POST | Bearer | Pesquisa passes, registos de entrega e leituras através de { query } (3 a 256 caracteres, correspondendo a e-mail, telefone, número de série ou externalId). | |||||
/api/v1/customer/:customerId/privacy-settings/data-subject-export | POST | Bearer | Gera um arquivo JSON IDataSubjectExportPayload ao abrigo dos Artigos 15.º/20.º do RGPD para { query }. | |||||
/api/v1/customer/:customerId/privacy-settings/data-subject-delete | POST | Bearer | Executa a anonimização/eliminação ao abrigo do Artigo 17.º do RGPD (request payload). |
Políticas Automatizadas de Retenção de Dados (RETENTION_POLICY_KEYS e RetentionAction)
Para impor a limitação da conservação (Artigo 5.º, n.º 1, alínea e) do RGPD), o Privacy Compliance API define 7 chaves de política canónicas (RETENTION_POLICY_KEYS):
-
Chaves do Ciclo de Vida do Passe:
neverWalletAddedPasses,passesWithoutActiveWalletRegistrations,passesByCreationAge,expiredPasses,passesNotModifiedSince. -
Chaves de Registos de Entrega:
emailDeliveryRecords,smsDeliveryRecords.
Cada política configura enabled (boolean), retentionDays (RETENTION_MIN_DAYS a RETENTION_MAX_DAYS, alinhando-se com predefinições como 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'):
{
"policies": {
"neverWalletAddedPasses": {
"enabled": true,
"retentionDays": 30,
"action": "delete"
},
"expiredPasses": {
"enabled": true,
"retentionDays": 90,
"action": "anonymize"
},
"emailDeliveryRecords": {
"enabled": true,
"retentionDays": 365,
"action": "delete"
}
}
}
Antes de executar uma limpeza, invoque POST /api/v1/customer/:customerId/privacy-settings/retention/neverWalletAddedPasses/preview para inspecionar as contagens de registos afetados sem alterar dados.
Executar Direitos dos Titulares dos Dados do RGPD (request payload / request payload / request payload)
Quando um titular de passe submete um pedido de acesso do titular dos dados (SAR) ou um pedido de direito ao apagamento:
-
1
Localizar Registos (
POST .../data-subject-search): Submeta{ "query": "customer@example.com" }(também corresponde aexternalId, telefone ouserialNumber) para devolver correspondências agrupadasIDataSubjectSearchResultGroupem passes e registos. -
2
Exportar Arquivo Portátil (
POST .../data-subject-export): Submeta{ "query": "customer@example.com" }para receberIDataSubjectExportPayload({ exportedAt, workspaceId, queryLength, groups, totalCount }). -
3
Apagamento Verificado (
POST .../data-subject-delete): Requer{ 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
}
Resposta (200 OK — IDataSubjectDeletionSummary):
{
"passesAnonymized": 2,
"deliveryRecordsDeleted": 6,
"skippedProtected": 0
}
Importante: A execução do apagamento no servidor (
POST .../data-subject-delete) anonimiza/elimina os dados pessoais nas bases de dados do Passinstance e respeita as retenções legais ativas (retentionHoldUntil). Contudo, como a Apple Wallet armazena ficheiros.pkpassassinados localmente no iPhone do utilizador, o titular do passe continua a ter de tocar em Remover Passe dentro da Apple Wallet para eliminar o cartão em cache do seu dispositivo físico.
Consulte os nossos compromissos legais completos na Política de Privacidade e no Centro de Segurança e Confiança.
