Skip to content
Guia da Central de Ajuda · Segurança e conformidade
3 min de leituraVerificado 2026-11-16

Privacidade de dados e RGPD

Configure modelos em Modo Privacidade, gestão de consentimentos, limpeza automática e pedidos de eliminação.

Neste guia

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).

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
RETENÇÃO RGPD E DIREITOS DOS TITULARES (DSR)
ETAPA 01 MOTOR DE RETENÇÃO AUTOMATIZADA (/customer/:customerId/privacy-settings/retention)
Políticas (RETENTION_POLICY_KEYS): neverWalletAddedPasses, passesWithoutActiveWalletRegistrations, passesByCreationAge, expiredPasses, passesNotModifiedSince, emailDeliveryRecords, smsDeliveryRecords
Pré-visualizar: POST.../retention/:policyKey/preview
Executar: POST.../retention/:policyKey/run?dryRun=true|false
ETAPA 02 PIPELINE DE DIREITOS DOS TITULARES (/customer/:customerId/privacy-settings)
1
Descoberta (POST.../data-subject-search): { query }grupos
2
Portabilidade (POST.../data-subject-export): { query }arquivo JSON
3
Apagamento (POST.../data-subject-delete): { query, confirmationPhrase, reason, requestVerified: true }IDataSubjectDeletionSummary

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 EndpointMétodoAutenticaçãoFuncionalidade
/api/v1/customer/:customerId/privacy-settingsGETBearerObtém as definições gerais de rastreio, aspetos legais e privacidade do espaço de trabalho.
/api/v1/customer/:customerId/privacy-settings/retentionGET / PATCHBearerLista ou atualiza (request payload) as políticas de retenção indexadas por RETENTION_POLICY_KEYS.
/api/v1/customer/:customerId/privacy-settings/retention/activityGETBearerLista as execuções recentes agendadas e manuais de retenção (RetentionRunStatus: `SCHEDULEDRUNNINGCOMPLETEDCOMPLETED_WITH_WARNINGSFAILEDCANCELLED`).
/api/v1/customer/:customerId/privacy-settings/retention/:policyKey/previewPOSTBearerExecuta 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/runPOSTBearerExecuta a política imediatamente (suporta ?dryRun=true).
/api/v1/customer/:customerId/privacy-settings/data-subject-searchPOSTBearerPesquisa 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-exportPOSTBearerGera um arquivo JSON IDataSubjectExportPayload ao abrigo dos Artigos 15.º/20.º do RGPD para { query }.
/api/v1/customer/:customerId/privacy-settings/data-subject-deletePOSTBearerExecuta 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'):

JSON
{
  "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. 1
    Localizar Registos (POST .../data-subject-search): Submeta { "query": "customer@example.com" } (também corresponde a externalId, telefone ou serialNumber) para devolver correspondências agrupadas IDataSubjectSearchResultGroup em passes e registos.
  2. 2
    Exportar Arquivo Portátil (POST .../data-subject-export): Submeta { "query": "customer@example.com" } para receber IDataSubjectExportPayload ({ exportedAt, workspaceId, queryLength, groups, totalCount }).
  3. 3
    Apagamento Verificado (POST .../data-subject-delete): Requer { 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
}

Resposta (200 OK — IDataSubjectDeletionSummary):

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

Documentação de produto e API relacionada

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.