Skip to content
Guía del Centro de ayuda · Seguridad y cumplimiento
4 min de lecturaVerificado 2026-11-16

Privacidad de datos y RGPD

Configura plantillas en modo privacidad, gestión de consentimientos, limpieza automática y derecho de supresión.

En esta guía

Gobernanza de Privacidad desde el Diseño y Cumplimiento del RGPD

Passinstance permite a las organizaciones europeas y globales operar programas de fidelización, venta de entradas y membresías en billeteras digitales en estricto cumplimiento del Reglamento General de Protección de Datos (RGPD) de la UE y la CCPA. A través de Privacy Compliance API (/api/v1/customer/:customerId/privacy-settings/*) y en el Panel en Configuración del Espacio de Trabajo -> Privacidad (/settings/workspace/privacy), los espacios de trabajo pueden aplicar la minimización de datos, automatizar la depuración por retención (RETENTION_POLICY_KEYS) y ejecutar flujos de trabajo verificables de Derechos de los Interesados (DSR).

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
RETENCIÓN RGPD Y DERECHOS DE LOS INTERESADOS (DSR)
ETAPA 01 MOTOR DE RETENCIÓN AUTOMATIZADO (/customer/:customerId/privacy-settings/retention)
Políticas (RETENTION_POLICY_KEYS): neverWalletAddedPasses, passesWithoutActiveWalletRegistrations, passesByCreationAge, expiredPasses, passesNotModifiedSince, emailDeliveryRecords, smsDeliveryRecords
Vista previa: POST.../retention/:policyKey/preview
Ejecución: POST.../retention/:policyKey/run?dryRun=true|false
ETAPA 02 PIPELINE DE DERECHOS DEL INTERESADO (DSR) (/customer/:customerId/privacy-settings)
1
Descubrimiento (POST.../data-subject-search): { query }coincidencias
2
Portabilidad (POST.../data-subject-export): { query }archivo JSON
3
Supresión (POST.../data-subject-delete): { query, confirmationPhrase, reason, requestVerified: true }IDataSubjectDeletionSummary

Referencia de la API de Privacidad y Retención de Datos (Privacy Compliance API)

Todos los endpoints de privacidad, retención y Derechos de los Interesados del RGPD están delimitados por inquilino bajo /api/v1/customer/:customerId/privacy-settings:

Ruta del EndpointMétodoAutenticaciónFuncionalidad
/api/v1/customer/:customerId/privacy-settingsGETBearerRecupera la configuración general de seguimiento, aspectos legales y privacidad del espacio de trabajo.
/api/v1/customer/:customerId/privacy-settings/retentionGET / PATCHBearerLista o actualiza (request payload) las políticas de retención indexadas por RETENTION_POLICY_KEYS.
/api/v1/customer/:customerId/privacy-settings/retention/activityGETBearerLista las ejecuciones recientes de retención manuales y programadas (RetentionRunStatus: `SCHEDULEDRUNNINGCOMPLETEDCOMPLETED_WITH_WARNINGSFAILEDCANCELLED`).
/api/v1/customer/:customerId/privacy-settings/retention/:policyKey/previewPOSTBearerEjecuta un simulacro no destructivo que devuelve el recuento exacto de registros elegibles para :policyKey.
/api/v1/customer/:customerId/privacy-settings/retention/:policyKey/runPOSTBearerEjecuta la política de inmediato (admite ?dryRun=true).
/api/v1/customer/:customerId/privacy-settings/data-subject-searchPOSTBearerBusca pases, registros de entrega y escaneos mediante { query } (3–256 caracteres, coincidiendo con correo, teléfono, número de serie o externalId).
/api/v1/customer/:customerId/privacy-settings/data-subject-exportPOSTBearerGenera un archivo JSON IDataSubjectExportPayload conforme a los artículos 15 y 20 del RGPD para { query }.
/api/v1/customer/:customerId/privacy-settings/data-subject-deletePOSTBearerEjecuta la anonimización o eliminación conforme al artículo 17 del RGPD (request payload).

Políticas Automatizadas de Retención de Datos (RETENTION_POLICY_KEYS y RetentionAction)

Para aplicar la limitación del plazo de conservación (artículo 5(1)(e) del RGPD), Privacy Compliance API define 7 claves de política canónicas (RETENTION_POLICY_KEYS):

  • Claves del Ciclo de Vida del Pase: neverWalletAddedPasses, passesWithoutActiveWalletRegistrations, passesByCreationAge, expiredPasses, passesNotModifiedSince.
  • Claves de Registros de Entrega: emailDeliveryRecords, smsDeliveryRecords.

Cada política configura enabled (boolean), retentionDays (de RETENTION_MIN_DAYS a RETENTION_MAX_DAYS, alineado con valores predefinidos como DataRetentionPolicy: KEEP_FOREVER | DELETE_AFTER_30_DAYS | DELETE_AFTER_90_DAYS | DELETE_AFTER_1_YEAR | DELETE_AFTER_7_YEARS | CUSTOM) y 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 ejecutar una depuración, llame a POST /api/v1/customer/:customerId/privacy-settings/retention/neverWalletAddedPasses/preview para inspeccionar el recuento de registros afectados sin mutar los datos.

Ejecución de los Derechos de los Interesados del RGPD (request payload / request payload / request payload)

Cuando un titular de pase envía una solicitud de acceso del interesado (SAR) o una solicitud de derecho de supresión:

  1. 1
    Localizar Registros (POST .../data-subject-search): Envíe { "query": "customer@example.com" } (también coincide con externalId, teléfono o serialNumber) para devolver coincidencias agrupadas de IDataSubjectSearchResultGroup entre pases y registros.
  2. 2
    Exportar Archivo Portátil (POST .../data-subject-export): Envíe { "query": "customer@example.com" } para recibir IDataSubjectExportPayload ({ exportedAt, workspaceId, queryLength, groups, totalCount }).
  3. 3
    Supresión Verificada (POST .../data-subject-delete): Requiere { 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
}

Respuesta (200 OK — IDataSubjectDeletionSummary):

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

Importante: Ejecutar la supresión en el lado del servidor (POST .../data-subject-delete) anonimiza o depura los datos personales en las bases de datos de Passinstance y respeta las retenciones activas (retentionHoldUntil). Sin embargo, dado que Apple Wallet almacena archivos .pkpass firmados localmente en el iPhone del usuario, el titular del pase aún debe tocar Eliminar Pase dentro de Apple Wallet para borrar la tarjeta almacenada en caché de su dispositivo físico.

Consulte todos nuestros compromisos legales en la Política de Privacidad y en el Centro de Seguridad y Confianza.

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.