Skip to content
Guía del Centro de ayuda · Integraciones Wallet
4 min de lecturaVerificado 2026-11-16

Diferencias y límites entre plataformas

Compara Apple Wallet, Google Wallet y Samsung Wallet en mensajes push, geocercas y zonas de campos.

En esta guía

Comparativa arquitectónica: Apple Wallet frente a Google Wallet

Aunque Passinstance ofrece un diseñador unificado de plantillas y una API REST que abstrae la complejidad de cada plataforma, Apple Wallet y Google Wallet difieren sustancialmente en cómo empaquetan, estilizan, actualizan y contabilizan los pases a nivel de sistema operativo:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
SERIALIZACIÓN DUAL Y DIVERGENCIA DE SINCRONIZACIÓN
ETAPA 01 PLANTILLA Y REGISTRO DE PASE UNIFICADOS PASSINSTANCE
Esquema único de plantilla + Atributos dinámicos + Motor de mecánicas
Serializador Apple Wallet
ETAPA 02A
Artefacto: Paquete ZIP .pkpass
Colores: Formato estricto rgb(r,g,b)
Diseño: Anverso fijo + Reverso girab.
Texto enriquecido: <a> en Reverso
Sinc.: Push vacío APNs {}Pull
Medición: Por dispositivo (iPhone+W)
Serializador Google Wallet
ETAPA 02B
Artefacto: Class + Object nube
Colores: Hexadecimal #RRGGBB
Diseño: Vista vertical desplazable
Texto enriquecido: `Google Wallet l
Sinc.: PATCH REST directo nube
Medición: Por objeto de pase único

Matriz técnica de comparación detallada

Característica / Restricción técnicaApple Wallet (iOS y watchOS)Google Wallet (Android)Samsung Wallet (Acceso mediante socios)
Artefacto de entregaArchivo ZIP .pkpass firmado (application/vnd.apple.pkpass)URL Save JWT firmada con RS256 (https://pay.google.com/gp/v/save/<jwt>) + Objeto REST en nubeReferencia de tarjeta restringida por socio (samsungWalletCardId, samsungWalletRefId)
Serialización de colorObligatorio rgb(r, g, b) (iOS rechaza códigos hex y canal alfa)Hexadecimal #RRGGBB (hexBackgroundColor)Hexadecimal #RRGGBB
Zonas de diseño de campos6 zonas diferenciadas: header, primary, secondary, auxiliary, back, footerSecciones verticales: cardTitle, subheader, header, textModulesData (filas), linksModuleDataRanuras propias de plantilla del fabricante
HTML y enlaces clicablesPermitido únicamente en backFields mediante attributedValue (solo etiquetas <a href="...">)Renderizado mediante array estructurado linksModuleData.uris (uri, description)Campos de enlace dedicados
Protocolo de actualización y pushDos pasos: push silencioso APNs HTTP/2 (payload {}, máx. 4096 bytes) despierta al iPhone para descargar GET /v1/passes/...Un paso: el servidor ejecuta PATCH REST sobre walletobjects/v1/...; Google Play Services sincroniza con el teléfonoAPI REST del proveedor
Disparador de alerta en pantalla de bloqueoCambia el valor de un campo que define changeMessage: "... %@"notifyPreference: "NOTIFY_ON_UPDATE" o addMessage (TEXT_AND_NOTIFY, máx. 3 cada 24 h)No habilitado como superficie push principal
Medición de pases activosPor cada deviceLibraryIdentifier registrado (1 iPhone + 1 Apple Watch emparejado = 2 registros)Deduplicado por cada <issuerId>.<objectId> único entre todos los dispositivos Android con la misma cuenta de GooglePor cuenta donde esté habilitado
Geocercas y balizas (Beacons)Hasta 10 coordenadas GPS (locations) + hasta 10 BLE iBeacons (beacons) por .pkpassHasta 10 coordenadas GPS en Class/Object (nota sobre locations: obsoleto/restringido por Google en versiones recientes de Play Services)Dependiente del dispositivo
Telemetría de eliminaciónLlamada inmediata DELETE /v1/devices/:deviceLibId/registrations/... al eliminar del WalletCallback inmediato POST /api/v1/wallet/callback con eventType: "del"Telemetría limitada
Protocolo NFC sin contactoApple VAS (ISO/IEC 14443 Tipo A/B, ECDH P-256, requiere permiso NFC de Apple)Google Smart Tap (NFC_SMART_TAP, collectorId, ECDH P-256)No compatible

Importante: No trate Samsung Wallet como globalmente equivalente a Apple Wallet y Google Wallet en todas las regiones y espacios de trabajo. Aunque Passinstance API mantiene campos en el esquema (samsungWalletCardId, samsungWalletRefId) para integraciones Samsung, Samsung Wallet requiere incorporación concertada por región como socio: consulte el Alcance de soporte de Samsung Wallet para conocer los criterios de elegibilidad.

Reglas de diseño y payloads específicas de cada plataforma

1. Conversión cromática y aplicación de contraste

El analizador PassKit de Apple rechaza archivos .pkpass si backgroundColor, foregroundColor o labelColor contienen una cadena hexadecimal #RRGGBB o un canal alfa rgba(). Passinstance almacena modelos de color normalizados (Color) y serializa automáticamente rgb(r, g, b) para generar el .pkpass de Apple, mientras emite #RRGGBB para las clases de Google Wallet.

2. Restricciones de anclas HTML en attributedValue

En Apple Wallet, los hipervínculos clicables, números de teléfono (tel:) y enlaces de correo (mailto:) son compatibles exclusivamente en el reverso del pase (backFields) mediante la propiedad attributedValue. Apple elimina cualquier etiqueta HTML excepto <a href="...">...</a>. En Google Wallet, Passinstance asigna estos enlaces a la sección estructurada linksModuleData al final de la vista desplazable del pase:

JSON
{
  "appleBackField": {
    "key": "website",
    "label": "TERMS & CONDITIONS",
    "value": "https://yourbrand.com/terms",
    "attributedValue": "<a href=\"https://yourbrand.com/terms\">View Terms & Conditions</a>"
  },
  "googleLinksModule": {
    "uris": [
      {
        "uri": "https://yourbrand.com/terms",
        "description": "View Terms & Conditions",
        "id": "link_terms"
      }
    ]
  }
}

3. Recuento de registros en múltiples dispositivos (iPhone + Apple Watch)

Cuando el propietario de un iPhone con un Apple Watch emparejado instala un pase de Apple Wallet, tanto iOS como watchOS registran independientemente su deviceLibraryIdentifier y su pushToken de APNs frente a POST /v1/devices/.../registrations/.... Passinstance registra tanto installedDevices (total de endpoints push) como uniqueDevices en el panel de analíticas para que pueda distinguir entre titulares únicos e instalaciones en varios dispositivos.

Revise Apple Wallet, Google Wallet y Diseño y configuración de plantillas para ver buenas prácticas de diseño.

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.