Como Funciona a Instalação Inteligente de Passes
Adicionar um cartão de fidelização, bilhete de evento, cartão de membro ou cupão ao seu smartphone demora menos de 10 segundos e não requer a transferência de aplicações de terceiros. Quando abre uma ligação inteligente do Passinstance, o servidor deteta o sistema operativo do seu dispositivo e encaminha-o para um pacote .pkpass da Apple Wallet (assinado com o Pass Type ID bundleId do comerciante) ou para um JWT de gravação na Google Wallet assinado com RS256.
Endpoints de Distribuição Inteligente
O Passinstance disponibiliza fluxos de instalação para titulares de passes através de três padrões de rotas públicas geridos por Download Page API e Public Download Page:
| Padrão de Rota | Método | Finalidade |
|---|---|---|
/d/:slug | GET | Ligação curta personalizada para SMS, cartazes QR e campanhas de e-mail. Efetua a deteção automática do sistema operativo e a entrega na carteira. |
/download/:slug | GET | Página de transferência explícita que apresenta a pré-visualização do passe, o tema da marca e botões Adicionar à Carteira específicos da plataforma. |
/s/:token | GET | Ligação com token de acesso individual assinado criptograficamente, com expiração opcional (downloadUntil) e verificação de PIN. |
Guia Passo a Passo para Titulares de Passes
1. No iPhone e Apple Watch (Apple Wallet)
-
1
Toque na sua ligação pessoal do passe para que abra no Safari (se tiver tocado na ligação dentro do Instagram, TikTok ou LinkedIn, toque no ícone do navegador no canto inferior direito para abrir no Safari nativo).
-
2
Toque em Adicionar à Apple Wallet — o iOS reconhece imediatamente o pacote
application/vnd.apple.pkpasse apresenta o ecrã nativo de pré-visualização do passe. -
3
Toque em Adicionar no canto superior direito do ecrã de pré-visualização.
-
4
Sincronização com o Apple Watch: Se utilizar um Apple Watch emparelhado, o iOS reflete automaticamente os passes elegíveis na aplicação Carteira no seu pulso.
-
5
Acesso Rápido: Faça duplo clique no botão lateral do seu iPhone em qualquer altura para apresentar o passe guardado na caixa de pagamento ou à entrada do recinto.
2. No Android (Google Wallet)
-
1
Abra a ligação do seu passe no Google Chrome ou no navegador predefinido do Android.
-
2
Toque em Adicionar à Google Wallet — isto abre o ecrã de gravação autenticado da Google (
https://pay.google.com/gp/v/save/<jwt>). -
3
Verifique se a Conta Google apresentada no topo do ecrã corresponde à conta iniciada na aplicação Google Wallet do seu telemóvel e, em seguida, toque em Adicionar à Carteira.
-
4
Toque em Ver na Carteira para apresentar imediatamente o seu código de barras ou passe NFC sem contacto.
3. Abrir uma Ligação de Passe num Computador Portátil ou de Secretária
Os computadores de secretária não executam nativamente a Apple Wallet nem a Google Wallet. Quando abre uma ligação /d/:slug ou /s/:token no macOS ou Windows:
{
"detectedPlatform": "DESKTOP",
"handoffMode": "QR_CODE_LANDING_PAGE",
"qrTargetUrl": "https://wallet.yourbrand.com/s/eyJhbGciOiJIUzI1Ni...",
"instructions": "Scan this QR code with your iPhone or Android camera to add the pass directly to your phone."
}
Aponte a câmara do seu iPhone ou Android para o código QR apresentado no ecrã e toque na notificação que surge para concluir a instalação no seu telemóvel.
Importante: Alguns emissores protegem cartões VIP de elevado valor ou cartões de identificação de colaboradores com vinculação a um único dispositivo (
limitToOneActivePerPass: true) ou com um PIN de transferência. Se lhe for solicitado, introduza o PIN enviado para o seu e-mail ou SMS antes de tocar em Adicionar à Carteira.
Está com dificuldades em instalar o seu cartão? Consulte Resolver Problemas da Carteira ou saiba como localizar um cartão existente em Encontrar ou Recuperar o Seu Passe.
