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:
Matriz técnica de comparación detallada
| Característica / Restricción técnica | Apple Wallet (iOS y watchOS) | Google Wallet (Android) | Samsung Wallet (Acceso mediante socios) |
|---|---|---|---|
| Artefacto de entrega | Archivo ZIP .pkpass firmado (application/vnd.apple.pkpass) | URL Save JWT firmada con RS256 (https://pay.google.com/gp/v/save/<jwt>) + Objeto REST en nube | Referencia de tarjeta restringida por socio (samsungWalletCardId, samsungWalletRefId) |
| Serialización de color | Obligatorio rgb(r, g, b) (iOS rechaza códigos hex y canal alfa) | Hexadecimal #RRGGBB (hexBackgroundColor) | Hexadecimal #RRGGBB |
| Zonas de diseño de campos | 6 zonas diferenciadas: header, primary, secondary, auxiliary, back, footer | Secciones verticales: cardTitle, subheader, header, textModulesData (filas), linksModuleData | Ranuras propias de plantilla del fabricante |
| HTML y enlaces clicables | Permitido ú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 push | Dos 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éfono | API REST del proveedor |
| Disparador de alerta en pantalla de bloqueo | Cambia 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 activos | Por 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 Google | Por cuenta donde esté habilitado |
| Geocercas y balizas (Beacons) | Hasta 10 coordenadas GPS (locations) + hasta 10 BLE iBeacons (beacons) por .pkpass | Hasta 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ón | Llamada inmediata DELETE /v1/devices/:deviceLibId/registrations/... al eliminar del Wallet | Callback inmediato POST /api/v1/wallet/callback con eventType: "del" | Telemetría limitada |
| Protocolo NFC sin contacto | Apple 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 APImantiene 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:
{
"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.
