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.
Atualizar o Seu Cartão e Gerir Notificações no Ecrã Bloqueado
No iPhone (Apple Wallet)
-
1
Abra a aplicação Carteira (Wallet) e toque no seu cartão.
-
2
Toque em
...(Mais / Detalhes do Cartão) no canto superior direito para consultar o verso. -
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
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
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
Abra a aplicação Google Wallet e selecione o seu cartão.
-
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 Endpoint | Método | Emissor | Descrição |
|---|---|---|---|
/v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumber | DELETE | Apple PassKit | Invocado automaticamente pelo iOS quando o titular toca em Remover Cartão no Apple Wallet (passTypeIdentifier = Apple bundleId). |
/api/v1/wallet/callback | POST | Google Wallet | Webhook enviado pelo Google Cloud (eventType: "del") quando o utilizador remove o cartão no Android. |
/email/unsubscribe/:token | POST / GET | Cliente de E-mail / Utilizador | POST processa RFC 8058 List-Unsubscribe=One-Click; GET redireciona em segurança para a interface de preferências sem alterar estado. |
/email/preferences/:token | GET | Browser do Titular | Abre 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)
{
"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 (
installedDevicesdiminui), 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.
