Skip to content
Guia da Central de Ajuda · Integrações Wallet
4 min de leituraVerificado 2026-11-16

Diferenças e limitações entre plataformas

Compare Apple Wallet, Google Wallet e Samsung Wallet em alertas de ecrã bloqueado, geocercas e zonas de campos.

Neste guia

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:

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
DIVERGÊNCIA DE SERIALIZAÇÃO E SINCRONIZAÇÃO
ETAPA 01 MODELO E REGISTO DE PASSE UNIFICADOS PASSINSTANCE
Esquema Único de Modelo + Atributos Dinâmicos + Motor de Estado Mecânicas
Serializador Apple Wallet
ETAPA 02A
Artefacto: Pacote ZIP .pkpass assin.
Cores: Formato estrito rgb(r, g, b)
Layout: Cartão Fixo Frente + Verso
Texto Rico: <a> nos Campos do Verso
Sync: Push APNs Vazio {}Pull
Medição: Por Dispos. (iPhone + Watch)
Serializador Google Wallet
ETAPA 02B
Artefacto: Class + Object Cloud
Cores: Hexadecimal #RRGGBB
Layout: Vista Vertical Deslizável
Texto Rico: `Google Wallet links mo
Sync: Cloud REST PATCH Direto
Medição: Por Objeto Único Passe

Matriz técnica detalhada de comparação

Funcionalidade / Limitação técnicaApple Wallet (iOS e watchOS)Google Wallet (Android)Samsung Wallet (Acesso via Parceiro)
Artefacto de entregaPacote ZIP .pkpass assinado (application/vnd.apple.pkpass)URL Save JWT assinado RS256 (https://pay.google.com/gp/v/save/<jwt>) + Objeto Cloud RESTReferência de cartão restrita a parceiros (samsungWalletCardId, samsungWalletRefId)
Serialização de coresTem de ser rgb(r, g, b) (hex e canais alfa rejeitados pelo iOS)Hexadecimal #RRGGBB (hexBackgroundColor)Hexadecimal #RRGGBB
Zonas de layout dos campos6 zonas discretas: header, primary, secondary, auxiliary, back, footerSecções verticais: cardTitle, subheader, header, textModulesData (linhas), linksModuleDataSlots de modelo do fornecedor
HTML / Ligações clicáveisPermitidas 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 pushDuas 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óvelAPI REST do fornecedor
Gatilho de alerta ecrã bloqueadoO 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 ativosPor deviceLibraryIdentifier registado (1 iPhone + 1 Apple Watch emparelhado = 2 registos)Desduplicado por <issuerId>.<objectId> único entre todos os Android com a mesma Conta GoogleDelimitado à conta quando ativo
Geofencing e beaconsAté 10 coordenadas GPS (locations) + até 10 iBeacons BLE (beacons) por .pkpassAté 10 coordenadas GPS em Class/Object (nota: locations descontinuado/restringido pela Google em Play Services recentes)Dependente do dispositivo
Telemetria de eliminaçãoChamada imediata DELETE /v1/devices/:deviceLibId/registrations/... ao remover da CarteiraCallback imediato POST /api/v1/wallet/callback com eventType: "del"Telemetria limitada
Protocolo NFC sem contactoApple 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 API mantenha 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:

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

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.