Comparação arquitetural: Apple Wallet vs. Google Wallet
Embora a Passinstance disponibilize um editor unificado de modelos e uma API REST que abstraem a complexidade das plataformas, a Apple Wallet e a Google Wallet diferem fundamentalmente na forma como os passes são empacotados, estilizados, atualizados e contabilizados ao nível do sistema operativo:
Matriz técnica detalhada de comparação
| Funcionalidade / Limitação técnica | Apple Wallet (iOS e watchOS) | Google Wallet (Android) | Samsung Wallet (Acesso via Parceiro) |
|---|---|---|---|
| Artefacto de entrega | Pacote ZIP .pkpass assinado (application/vnd.apple.pkpass) | URL Save JWT assinado RS256 (https://pay.google.com/gp/v/save/<jwt>) + Objeto Cloud REST | Referência de cartão restrita a parceiros (samsungWalletCardId, samsungWalletRefId) |
| Serialização de cores | Tem de ser rgb(r, g, b) (hex e canais alfa rejeitados pelo iOS) | Hexadecimal #RRGGBB (hexBackgroundColor) | Hexadecimal #RRGGBB |
| Zonas de layout dos campos | 6 zonas discretas: header, primary, secondary, auxiliary, back, footer | Secções verticais: cardTitle, subheader, header, textModulesData (linhas), linksModuleData | Slots de modelo do fornecedor |
| HTML / Ligações clicáveis | Permitidas apenas em backFields via attributedValue (apenas etiquetas <a href="...">) | Apresentadas na matriz dedicada linksModuleData.uris (uri, description) | Campos de ligação dedicados |
| Protocolo de atualização e push | Duas etapas: push silencioso APNs HTTP/2 (payload {}, máx. 4096 bytes) acorda iPhone para obter GET /v1/passes/... | Etapa única: Servidor executa REST PATCH em walletobjects/v1/...; Google Play Services envia para o telemóvel | API REST do fornecedor |
| Gatilho de alerta ecrã bloqueado | O valor muda num campo com changeMessage: "... %@" | notifyPreference: "NOTIFY_ON_UPDATE" ou addMessage (TEXT_AND_NOTIFY, máx. 3 por 24h) | Não ativado como superfície push primária |
| Contabilização de passes ativos | Por deviceLibraryIdentifier registado (1 iPhone + 1 Apple Watch emparelhado = 2 registos) | Desduplicado por <issuerId>.<objectId> único entre todos os Android com a mesma Conta Google | Delimitado à conta quando ativo |
| Geofencing e beacons | Até 10 coordenadas GPS (locations) + até 10 iBeacons BLE (beacons) por .pkpass | Até 10 coordenadas GPS em Class/Object (nota: locations descontinuado/restringido pela Google em Play Services recentes) | Dependente do dispositivo |
| Telemetria de eliminação | Chamada imediata DELETE /v1/devices/:deviceLibId/registrations/... ao remover da Carteira | Callback imediato POST /api/v1/wallet/callback com eventType: "del" | Telemetria limitada |
| Protocolo NFC sem contacto | Apple VAS (ISO/IEC 14443 Tipo A/B, ECDH P-256, requer autorização Apple NFC) | Google Smart Tap (NFC_SMART_TAP, collectorId, ECDH P-256) | Não suportado |
Importante: Não trate a Samsung Wallet como globalmente idêntica à Apple Wallet e Google Wallet em todas as regiões e espaços de trabalho. Embora o
Passinstance APImantenha campos de esquema (samsungWalletCardId,samsungWalletRefId) para integrações Samsung, a Samsung Wallet exige integração mediada por parceiro consoante a região — consulte o Âmbito de Suporte Samsung Wallet para detalhes de elegibilidade.
Regras de design e payload específicas de cada plataforma
1. Conversão de cores e garantia de contraste
O analisador PassKit da Apple rejeita ficheiros .pkpass se backgroundColor, foregroundColor ou labelColor contiver uma string hex #RRGGBB ou um canal alfa rgba(). A Passinstance armazena modelos de cor normalizados (Color) e serializa automaticamente rgb(r, g, b) na geração Apple .pkpass emitindo #RRGGBB para as classes Google Wallet.
2. Restrições de âncoras HTML em attributedValue
Na Apple Wallet, hiperligações clicáveis, números de telefone (tel:) e ligações mailto são suportados exclusivamente no verso do passe (backFields) através da propriedade attributedValue. A Apple remove todas as etiquetas HTML exceto <a href="...">...</a>. Na Google Wallet, a Passinstance mapeia estas ligações para a secção estruturada linksModuleData na parte inferior da vista deslizável do passe:
{
"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. Contagens de registo multi-dispositivo (iPhone + Apple Watch)
Quando o proprietário de um iPhone com um Apple Watch emparelhado instala um passe Apple Wallet, o iOS e o watchOS registam cada um um deviceLibraryIdentifier e um pushToken APNs independentes junto de POST /v1/devices/.../registrations/.... A Passinstance acompanha tanto installedDevices (total de endpoints push) como uniqueDevices no Painel de Analítica para que possa distinguir titulares únicos de instalações em múltiplos dispositivos.
Consulte Apple Wallet, Google Wallet e Design e configuração de modelos para boas práticas de layout.
