Skip to content
Guia da Central de Ajuda · Ajuda para titulares de passes
3 min de leituraVerificado 2026-11-16

Atualizar ou remover um passe

Ative atualizações automáticas, force a atualização do saldo, silencie alertas ou remova o cartão.

Neste guia

Como Funcionam as Atualizações Automáticas e a Telemetria de Remoção

Assim que um cartão é adicionado ao Apple Wallet ou Google Wallet, permanece ligado ao Passinstance para que saldos de pontos, carimbos, subidas de nível e alterações de porta de evento sejam atualizados automaticamente sem transferir um novo cartão. Quando remove um cartão do telemóvel, a aplicação Wallet notifica o backend para suspender o envio de atualizações.

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
PROTOCOLO DE ATUALIZAÇÃO E DESINSTALAÇÃO WALLET
ETAPA 01 ATUALIZAÇÃO EM TEMPO REAL DO CARTÃO
iOS: Push APNs silencioso {}iPhone chama GET/v1/passes/:bundleId/:serial
Android: Passinstance atualiza walletobjects via API REST do Google Wallet
ETAPA 02 TITULAR REMOVE O CARTÃO DO DISPOSITIVO
Apple Wallet emite: DELETE/v1/devices/:deviceId/registrations/:type/:serial
Google Wallet emite: POST/api/v1/wallet/callback (eventType: "del")
Cartão transita para Removed from Wallets (inactiveDeviceRegistrations)
ETAPA 03 PREFERÊNCIAS DE E-MAIL E MARKETING (Email Preferences API)
Anulação de subscrição 1 clique RFC 8058: POST/email/unsubscribe/:token
Redirecionamento no browser: GET/email/unsubscribe/:token
Portal de self-service: /email/preferences/:token

Atualizar o Seu Cartão e Gerir Notificações no Ecrã Bloqueado

No iPhone (Apple Wallet)

  1. 1
    Abra a aplicação Carteira (Wallet) e toque no seu cartão.
  2. 2
    Toque em ... (Mais / Detalhes do Cartão) no canto superior direito para consultar o verso.
  3. 3
    Verifique as Atualizações Automáticas: Confirme que Atualizações Automáticas está ATIVADO para que o cartão seja atualizado em segundo plano sempre que ganhar pontos ou carimbos.
  4. 4
    Atualização manual (puxar para atualizar): Se o telemóvel esteve em Modo de Avião ou com fraca cobertura na caixa, deslize suavemente para baixo no ecrã Detalhes do Cartão para forçar uma atualização imediata em GET /v1/passes/:passTypeIdentifier/:serialNumber.
  5. 5
    Silenciar avisos no ecrã bloqueado: Se pretender manter o cartão no Apple Wallet mas silenciar os alertas no ecrã bloqueado, desative Permitir Notificações no ecrã de detalhes.

No Android (Google Wallet)

  1. 1
    Abra a aplicação Google Wallet e selecione o seu cartão.
  2. 2
    Toque em ⋮ (menu de três pontos) no canto superior direito para consultar os detalhes e alternar Mostrar notificações deste cartão.

Remover um Cartão e Gerir Preferências de Comunicação

Quando elimina um cartão da sua Wallet ou cancela a subscrição de e-mails de campanhas, o Passinstance processa a alteração através dos seguintes endpoints:

Caminho do EndpointMétodoEmissorDescrição
/v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumberDELETEApple PassKitInvocado automaticamente pelo iOS quando o titular toca em Remover Cartão no Apple Wallet (passTypeIdentifier = Apple bundleId).
/api/v1/wallet/callbackPOSTGoogle WalletWebhook enviado pelo Google Cloud (eventType: "del") quando o utilizador remove o cartão no Android.
/email/unsubscribe/:tokenPOST / GETCliente de E-mail / UtilizadorPOST processa RFC 8058 List-Unsubscribe=One-Click; GET redireciona em segurança para a interface de preferências sem alterar estado.
/email/preferences/:tokenGETBrowser do TitularAbre o centro de preferências de self-service para controlo granular de consentimento de e-mail (alias /preferences/:token).

Como Remover um Cartão do Telemóvel

  • Apple Wallet: Abra o cartão → toque em ... (canto superior direito) → Remover Cartão → confirme Remover.
  • Google Wallet: Abra o cartão → toque em ⋮ (canto superior direito) → Remover → confirme Remover.

Exemplo: Callback de Remoção do Google Wallet (POST /api/v1/wallet/callback)

JSON
{
  "signature": "MEYCIQDa9...",
  "intermediateSigningKey": { "signedKey": "..." },
  "protocolVersion": "ECv2SigningOnly",
  "signedMessage": "{\"ISSUER_ID\":\"3388000000012345678\",\"OBJECT_ID\":\"3388000000012345678.pass_99102\",\"EVENT_TYPE\":\"del\",\"NONCE\":\"7b8a9c10\"}"
}

Importante: Remover um cartão do Apple Wallet ou Google Wallet elimina-o do telemóvel e interrompe notificações push no ecrã bloqueado (installedDevices diminui), mas não apaga a sua conta de cliente junto do comerciante. Para exercer direitos de eliminação ao abrigo do RGPD, contacte a entidade emissora ou consulte Privacidade de Dados e RGPD.

Precisa de restaurar um cartão removido por engano? Siga os passos em Encontrar ou Recuperar o Seu Cartão.

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.