Skip to content
Guia da Central de Ajuda · Ajuda para titulares de passesFase de integração 4
3 min de leituraVerificado 2026-11-16

Adicionar um passe à sua Wallet

Guia para o utilizador final guardar o cartão no iPhone, Android ou via código QR no computador.

Neste guia

Inspecione capturas de ecrã exatas do painel e detalhes ampliados relacionados com este guia.

Foco ampliado da interface
Elementos-chave da interface

Pré-visualização em tempo real Dual-Wallet (Zoom)

Alterne entre Apple e Google no painel de pré-visualização para confirmar as artes, a formatação do saldo, a legibilidade do código QR e o alinhamento dos campos.

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.

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
ENCAMINHAMENTO INTELIGENTE E ENTREGA NA CARTEIRA
ETAPA 01 TITULAR ABRE LIGAÇÃO INTELIGENTE (GET/d/:slug, /download/:slug ou /s/:token)
Public Download Page inspeciona User-Agent e controlos de token
ETAPA 02A STREAM APPLE WALLET
Transmite ZIP assinado `application
/vnd.apple.pkpass`
Sincroniza c/ Watch
ETAPA 02B REDIRECIONAMENTO GOOGLE
Assina JWT RS256
Redireciona para `https:
//pay.google.com/gp/v/...
Guarda na Conta Google
ETAPA 02C TRANSFERÊNCIA QR DESKTOP
Apresenta página responsiva com código
QR para leitura com a câmara do telemóvel

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 RotaMétodoFinalidade
/d/:slugGETLigaçã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/:slugGETPá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/:tokenGETLigaçã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. 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. 2
    Toque em Adicionar à Apple Wallet — o iOS reconhece imediatamente o pacote application/vnd.apple.pkpass e apresenta o ecrã nativo de pré-visualização do passe.
  3. 3
    Toque em Adicionar no canto superior direito do ecrã de pré-visualização.
  4. 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. 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. 1
    Abra a ligação do seu passe no Google Chrome ou no navegador predefinido do Android.
  2. 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. 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. 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:

JSON
{
  "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.

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.