Skip to content
Guia interativo de configuração e distribuição

Lance o seu primeiro programa Wallet

Crie, teste e distribua o seu primeiro cartão Apple Wallet ou Google Wallet com um guia claro passo a passo.

6
Fases de integração
6
Mecânicas de cartões
Apple WalletGoogle Wallet
Apple e Google
Plataformas Wallet
Jornada de integração em 6 fases

A sua jornada completa de configuração e distribuição

Siga estas seis fases sequenciais desde a preparação do espaço de trabalho até à distribuição aos clientes. Salte para qualquer fase ou marque as fases concluídas.

0 / 6 fases marcadas como concluídas
01
Fase 1 de 6

Prepare o seu espaço de trabalho

Verifique as definições do espaço de trabalho, as credenciais de assinatura da Carteira, as permissões da equipa e os dispositivos físicos antes de criar o primeiro modelo.

Pré-requisitos antes de iniciar esta fase

  • Conta ativa no Passinstance Studio (qualquer endereço de e-mail válido funciona)
  • Certificado Apple de Demonstração & Emissor Google Wallet gerido integrados para testes imediatos (ou o seu certificado Apple .cer para produção)
  • Permissões de perfil Proprietário do Espaço de Trabalho, Administrador ou Editor de Modelos
  • Um iPhone físico (Apple Wallet no iOS) ou telemóvel Android (Google Wallet) para verificação em dispositivo

Instruções passo a passo

  1. 1

    Verificar a identidade do espaço de trabalho e as definições da organização

    Abra as Definições da Conta no Passinstance Studio para confirmar o nome da organização, o fuso horário predefinido e o ambiente do espaço de trabalho.

  2. 2

    Verificar credenciais demo ou ligar certificados de produção

    Novos espaços de trabalho incluem automaticamente um Certificado Apple de Demonstração e um Emissor Google Wallet gerido para testar logo no telemóvel. Antes do lançamento ao público, carregue o certificado Apple Pass Type ID (.cer) em Definições → Wallet (ou Ferramentas de Programador → Certificados).

  3. 3

    Confirmar funções da equipa e permissões do scanner

    Garanta que os colaboradores que desenham modelos, emitem cartões ou operam o Scanner têm o perfil adequado atribuído no espaço de trabalho.

  4. 4

    Preparar um dispositivo de teste físico iOS e/ou Android

    Tenha um iPhone com Apple Wallet e/ou um dispositivo Android com Google Wallet com sessão iniciada e pronto para ler o primeiro código QR de teste.

Resultado esperado

O seu espaço de trabalho dispõe de credenciais ativas de sandbox ou produção e está pronto para criar e testar um modelo.

Foco ampliado da interface1 / 3
Elementos-chave da interface

Template Settings — Assinatura e External IDs (Ampliado)

Confira status de assinatura, ordenação na carteira, estado Published e regras de unicidade de External ID.

Detalhes práticos e comportamento da plataforma
  • Cada novo espaço provisiona automaticamente um Certificado Apple de Demonstração e um Emissor Google Wallet gerido para emitir e instalar cartões de teste reais no iOS e Android sem esperar pela conta Apple Developer.
  • A emissão em produção na Apple Wallet requer gerar um CSR em Ferramentas de Programador → Certificados (ou Definições → Wallet), criar o Pass Type ID na Apple Developer e carregar o ficheiro .cer.
  • Cada espaço de trabalho isola modelos, cartões de clientes, certificados e analítica por fronteira de cliente.
Resolução de problemas nesta fase

A publicação ou a criação de um cartão de teste é bloqueada por um aviso de certificado

Abra Definições → Wallet (ou Ferramentas de Programador → Certificados) no Studio, verifique o Certificado Apple de Demonstração ou carregue um ficheiro .cer válido e confirme o estado do Google Wallet Issuer.

Um membro da equipa não consegue editar modelos ou aceder às definições do Scanner

Peça a um Proprietário ou Administrador do Espaço de Trabalho para rever Membros da Equipa e Permissões e conceder acesso de Editor ou Operador de Scanner.

02
Fase 2 de 6

Desenhe o seu cartão

Selecione a estrutura do cartão, configure cores e campos, defina os atributos dinâmicos do cliente e associe a mecânica de negócio adequada.

Pré-requisitos antes de iniciar esta fase

  • Espaço de trabalho preparado (Fase 1)
  • Logótipo da marca e imagem opcional de faixa/fundo (recomenda-se PNG)
  • Decisão clara sobre o caso de utilização do cartão (Fidelização, Carimbos, Cupão, Evento ou Saldo pré-pago)

Instruções passo a passo

  1. 1

    Criar um modelo a partir da Galeria, Em branco, IA ou importação .pkpass

    Em Modelos, clique em Novo Modelo para começar com uma predefinição selecionada, layout em branco, instrução guiada por IA ou pacote .pkpass/JSON existente.

  2. 2

    Configurar tipo de cartão, cores, imagens e campos da frente/verso

    Defina o Nome do Modelo, Entidade Emissora, Descrição, cores RGB legíveis segundo WCAG, imagens de logótipo/faixa e os campos de Cabeçalho, Principal, Secundário/Rodapé, Auxiliar e Verso compatíveis com o tipo de cartão escolhido.

  3. 3

    Definir atributos dinâmicos do cliente

    Adicione propriedades personalizadas (como firstName, lastName, email, customerId ou tier) e associe-as aos campos com {key}.

  4. 4

    Selecionar e configurar a mecânica do cartão e regras de validação

    Escolha entre todas as 6 mecânicas Studio — Cartão de carimbos, Resgate de carimbos, Saldo pré-pago, Pontos e níveis, Validação diária ou Prolongar validade — e configure metas, prémios ou limiares.

Resultado esperado

O seu modelo apresenta uma pré-visualização em direto precisa na Apple Wallet e Google Wallet, com variáveis dinâmicas e regras de negócio configuradas.

Foco ampliado da interface1 / 9
Elementos-chave da interface

Menu de criação de novo modelo (Zoom)

Comece a partir de um modelo em branco, escolha um modelo pronto na Galeria de modelos, duplique um existente ou inicie Criar com IA.

Modelo de dados

Como funcionam em conjunto Tipo de cartão, Modelo, Mecânica, Atributo e Cartão emitido

1

Tipo de cartão

Define a estrutura base do layout e as posições dos campos na Apple Wallet e Google Wallet.

Cartão de loja, Cupão, Bilhete de evento, Passe genérico ou Cartão de embarque.
2

Modelo (Template)

A sua matriz reutilizável com identidade visual, textos fixos, variáveis dinâmicas e regras.

Modelo «Fidelização Grand Café VIP» no Passinstance Studio.
3

Mecânica de cartão

O motor de regras de negócio que controla como as leituras ou edições alteram o cartão.

Cartão de carimbos (8 carimbos = 1 prémio) ou Pontos e níveis (Prata → Ouro).
4

Atributo dinâmico

Uma variável específica do cliente associada a um campo do modelo.

{firstName} ou {points}.
5

Cartão emitido

Uma instância individual assinada criptograficamente e criada para um cliente específico.

Cartão #PI-9482 instalado na Apple Wallet da Ana.
Seletor interativo de mecânicas

Escolha e compare a mecânica do seu cartão

Ver no editor de modelos
Mecânica de cartão

Cartão de carimbos

Cartão digital de carimbos onde cada compra ou leitura elegível adiciona um carimbo até atingir a recompensa.

Conhecer os cartões de carimbos
Problema de negócio resolvido
Substitui os cartões em papel por carimbos digitais seguros atualizados em tempo real a cada visita.
Exemplo de caso de utilização
Exemplo: Colecione 8 carimbos de café para ganhar 1 bebida grátis.
Configuração necessária
Grelha de carimbos (3–5 colunas), ícone do carimbo (PNG 720 × 720 px), patamar de prémio e intervalo opcional anti-duplicação.
Requisitos de validação
A equipa lê o código QR com o Passinstance Scanner (ou via API do POS) para adicionar ou resgatar carimbos.
Atualização na Carteira
A Apple Wallet e a Google Wallet atualizam de imediato a faixa visual de carimbos e o contador por notificação push.
Limitações conhecidas
Cada modelo suporta uma mecânica ativa; alterações à grelha atualizam o visual na sincronização seguinte da Carteira.
Detalhes práticos e comportamento da plataforma
  • A Apple Wallet serializa cores em rgb(r, g, b) e o Passinstance adapta automaticamente os grupos de campos frontais e traseiros ao estilo selecionado (Genérico, Cartão Loja, Cupão, Bilhete Evento ou Cartão Embarque).
  • A Google Wallet bloqueia o tipo base da classe de cartão após a primeira emissão; escolha cuidadosamente o tipo de cartão antes de publicar.
  • As Propriedades Personalizadas definidas no modelo geram automaticamente campos de entrada na criação individual, nos formulários PassFlow e nos cabeçalhos de importação em lote CSV.
Resolução de problemas nesta fase

Uma variável dinâmica como {firstName} aparece literalmente no cartão

Verifique se a chave do atributo existe em Propriedades Personalizadas no Editor de Modelos e se a grafia da chave corresponde exatamente a maiúsculas e minúsculas.

O texto ou os rótulos sobre a faixa estão difíceis de ler na pré-visualização do cartão

Ajuste a Cor de Fundo, Cor do Rótulo e Cor do Valor no separador Identidade Visual ou ative a correção automática de contraste de texto.

03
Fase 3 de 6

Publique e emita um cartão de teste

Confirme a lista de verificação no editor, publique o modelo ativo e gere um primeiro cartão de teste com valores realistas.

Pré-requisitos antes de iniciar esta fase

  • Layout do modelo, atributos e mecânica concluídos (Fase 2)
  • Todos os campos obrigatórios válidos com indicadores de prontidão a verde

Instruções passo a passo

  1. 1

    Inspecionar validação no Editor e prontidão na Vista Geral

    Confirme no Editor de Modelos que Nome do Modelo, Entidade Emissora e Descrição são válidos e acompanhe o cartão de 3 pontos (Configuração, Design Wallet e Mecânicas) na Vista Geral do Modelo.

  2. 2

    Guardar alterações em rascunho e clicar em Publicar Modelo

    Clique em Guardar para gravar o estado do editor e, em seguida, clique em Publicar para que o modelo passe a Ativo e fique disponível para emitir cartões.

  3. 3

    Abrir Ações Rápidas → Criar um Cartão Individual

    Na página Vista Geral do Modelo, abra a janela de criação individual e introduza valores realistas de exemplo para cada atributo do cliente.

  4. 4

    Verificar a geração do cartão e identificadores únicos

    Confirme que o novo cartão aparece na tabela Passes com um ID de cartão único, payload QR/código de barras gerado e estado inicial.

Resultado esperado

Um cartão de teste assinado existe na lista Passes do seu modelo com um URL de instalação ativo e código QR pronto para testes em smartphone.

Foco ampliado da interface1 / 3
Elementos-chave da interface

Lista de verificação de publicação — Configuração concluída (Zoom)

Confirme que o Certificado de assinatura, as Regras de validação e a Página de transferência apresentam todos «Ready» (3 de 3 concluídos) antes de emitir cartões.

Comparação das ações principais

O que fazem realmente Guardar rascunho, Publicar modelo e Emitir cartão

1. Rascunho no Studio

Guardar rascunho

Guarda as suas edições visuais e de atributos dentro do Editor de Modelos.

Sem impacto nos cartões ativos. Não é possível emitir cartões a partir de um rascunho não publicado.

Enquanto ajusta cores, imagens e campos antes da revisão final.

2. Modelo ativo

Publicar modelo

Valida os campos obrigatórios, ativa a versão do modelo e sincroniza alterações com as Carteiras instaladas.

Desbloqueia a emissão de cartões e envia atualizações de layout para os cartões já instalados.

Quando a lista de verificação de publicação estiver verde e pronta para emissão.

3. Instância do cliente

Emitir cartão

Gera um registo assinado único, um token QR/código de barras e um URL de instalação para o destinatário.

Cria um cartão instalável na Apple Wallet (.pkpass) e Google Wallet para essa pessoa.

Para cartões de teste individuais, formulários PassFlow, importações CSV ou emissão por API.

Detalhes práticos e comportamento da plataforma
  • Guardar um rascunho nunca altera cartões já emitidos aos clientes; apenas a publicação torna as alterações do modelo ativas para novos cartões e sincronização em direto na Carteira.
  • Cada cartão emitido recebe um número de série criptográfico único e um token de validação no código de barras, mesmo quando dois clientes partilham o mesmo nome.
  • Pode emitir cartões de teste internos ilimitados e eliminá-los ou arquivá-los antes de lançar a distribuição para clientes.
Resolução de problemas nesta fase

O botão Publicar está desativado no Editor de Modelos

Preencha quaisquer campos obrigatórios em falta (Nome do Modelo, Entidade Emissora ou Descrição) no Editor de Modelos, guarde o rascunho e clique em Publicar.

Falta um campo de entrada do cliente esperado na janela Criar Cartão

Regresse ao Editor de Modelos → Propriedades Personalizadas, adicione o atributo e volte a publicar o modelo.

04
Fase 4 de 6

Teste a experiência na Carteira

Instale o cartão de teste num iPhone e/ou Android físico, verifique a apresentação real e valide o comportamento de leitura de códigos de barras/NFC.

Pré-requisitos antes de iniciar esta fase

  • Cartão de teste emitido com ligação de download ativa ou código QR (Fase 3)
  • iPhone físico (Safari/Câmara) e/ou dispositivo Android (Chrome/Google Wallet)

Instruções passo a passo

  1. 1

    Ler o código QR do cartão de teste no seu smartphone

    Abra a pré-visualização ou a ligação de download do cartão no seu telemóvel e toque em Adicionar à Apple Wallet ou Adicionar à Google Wallet.

  2. 2

    Inspecionar o layout frontal, campos do verso e código de barras

    Verifique o alinhamento do logótipo, o recorte da imagem de faixa, os valores dinâmicos do cliente, as ligações no verso do cartão e a nitidez do código QR/barras no ecrã do dispositivo real.

  3. 3

    Efetuar uma leitura de teste com o Passinstance Scanner (quando se utiliza validação)

    Abra o Passinstance Scanner (Web Scanner, app iOS ou perfil de Scanner configurado) e leia o código QR do cartão para verificar regras de carimbos, pontos, saldo ou check-in.

  4. 4

    Confirmar a atualização push em tempo real da Carteira no telemóvel

    Verifique que o cartão do cliente se atualiza automaticamente na Apple Wallet ou Google Wallet poucos segundos após a leitura ou edição no painel.

Resultado esperado

O seu cartão instala-se sem falhas no iOS e Android, é lido sem erros e reflete atualizações em direto de saldo/estado no ecrã bloqueado e dentro da Carteira.

Foco ampliado da interface1 / 5
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.

Apple Wallet

Apple Wallet (.pkpass no iPhone e Apple Watch)

Verifique o alinhamento dos campos de cabeçalho/principais/secundários, o contraste RGB, as ligações no verso do cartão e as notificações de atualização APNs no ecrã bloqueado.

Google Wallet

Google Wallet (JWT assinado no Android)

Verifique o dimensionamento da imagem hero/faixa, os módulos de texto estruturados, a apresentação do código de barras e a sincronização push REST da Google Wallet.

Disponibilidade e requisitos do Scanner

Como validar cartões por dispositivo e quando se aplica o teste com Scanner

Passinstance Scanner
Acesso imediato no navegador

Web Scanner (Navegador de computador e telemóvel)

Disponível de imediato para todos os espaços de trabalho com acesso à câmara. Ideal para testes rápidos de integração e computadores ou tablets na receção.

App nativa iOS

Passinstance Scanner para iPhone e iPad

Disponível para download no iOS para leitura ótica rápida de QR/códigos de barras e fluxos de validação pela equipa no ponto de venda.

Configuração obrigatória

Perfil de Configuração de Scanner

Em Vista Geral do Modelo → Scanner, crie uma Configuração de Scanner para definir que modo de leitura (Adicionar carimbo, Somar pontos, Resgatar ou Check-In) os operadores utilizam.

Provisionamento Android

APK Android e hardware empresarial

Vai implementar em terminais POS Android dedicados ou leitores portáteis Sunmi/Zebra? Contacte a nossa equipa para provisionamento gerido de APK.

Quando é opcional

Quando o teste com Scanner não é necessário

Se o seu cartão for um cartão de sócio estático, cartão de visita digital ou passe informativo atualizado via API/Painel sem controlo físico por leitura, pode ignorar a configuração do Scanner.

Detalhes práticos e comportamento da plataforma
  • Os ficheiros Apple Wallet (.pkpass) abrem nativamente no Safari e no Mail do iOS; nos navegadores de computador, a Passinstance apresenta uma página com código QR legível.
  • Os cartões Google Wallet exigem que o utilizador tenha sessão iniciada numa conta Google no Android ou web e sincronizam-se automaticamente na aplicação Google Wallet.
  • Se o seu cartão for apenas informativo (ex.: cartão VIP estático sem regras de check-in), pode dispensar o teste físico com scanner e verificar atualizações diretamente na tabela Passes do Studio.
Resolução de problemas nesta fase

A Apple Wallet ou Google Wallet não mostra imediatamente os pontos ou carimbos atualizados

Verifique a conectividade do dispositivo, confirme que o modelo foi publicado após editar os campos e deslize para baixo para atualizar o cartão (ou confirme a opção Atualizações Automáticas no verso do cartão no iOS).

O Scanner indica «Passe Inválido» ou «Intervalo de espera da regra ativo»

Confirme que o perfil de Scanner está ligado ao mesmo espaço de trabalho/modelo e verifique se existe uma janela de Validação Diária ou de bloqueio de leitura duplicada ativa.

05
Fase 5 de 6

Distribua os seus cartões

Escolha o canal de entrega certo para o seu público e distribua cartões através de ligações públicas, PassFlow, importação CSV ou Envios.

Pré-requisitos antes de iniciar esta fase

  • Modelo publicado e cartão de teste verificado (Fases 3–4)
  • Modo de acesso de distribuição selecionado (Público vs. Restrito)

Instruções passo a passo

  1. 1

    Configurar controlos de Distribuição e Acesso no modelo

    Em Vista Geral do Modelo → Distribuição, defina se as ligações são Públicas ou Restritas, configure datas de expiração e defina limites opcionais de emissão de cartões.

  2. 2

    Selecionar o método principal de distribuição

    Escolha Páginas de Download ou PassFlow para registo em autoatendimento, Cartão Individual para atendimento VIP 1-para-1 ou Importação CSV em Massa + Envios para listas CRM existentes.

  3. 3

    Mapear atributos e validar primeiro um pequeno lote piloto

    Ao importar um ficheiro CSV ou lançar um envio por e-mail/SMS, mapeie as colunas para as suas Propriedades Personalizadas e envie para 2–3 endereços internos antes do lançamento geral.

  4. 4

    Lançar o canal ou campanha de distribuição

    Partilhe o QR/URL público, incorpore o PassFlow no seu website ou inicie a tarefa de Envio a partir do Centro de Entrega.

Resultado esperado

Os clientes recebem a sua ligação personalizada ou código QR, abrem a página PassFlow adaptada ao dispositivo e adicionam o cartão à Apple Wallet ou Google Wallet com um toque.

Foco ampliado da interface1 / 4
Elementos-chave da interface

Limites de emissão e controlos de acesso (Zoom)

Configure emissão ilimitada ou limitada, canais de acesso, encaminhamento de Wallet e proteções como bloquear nova transferência após ativação e desduplicar destinatários.

Fluxo de entrega completo

Como um cartão chega da Passinstance ao smartphone do seu cliente

  1. Etapa 101

    Emitir registo do cartão

    A Passinstance cria uma instância do cartão através de Cartão Único, formulário PassFlow, Importação CSV ou API REST.

  2. Etapa 202

    Gerar URL de instalação único

    Cada cartão recebe um URL de instalação com deteção do dispositivo e um código QR associado ao seu token criptográfico.

  3. Etapa 303

    Entregar através do canal

    Partilhe a ligação através dos Envios da Passinstance (E-mail/SMS), do seu próprio CRM, de um botão no website ou de um cartaz QR impresso.

  4. Etapa 404

    Cliente abre o PassFlow

    O PassFlow deteta iOS, Android ou Computador (com sobreposição guiada opcional PassTour).

  5. Etapa 505

    Adicionar à Apple / Google Wallet

    O cliente toca em Adicionar à Carteira; o cartão instala-se no telemóvel e regista-se para atualizações push em tempo real.

Seletor interativo de distribuição

Compare as 6 formas de entregar cartões aos clientes

Selecione um método de entrega abaixo para consultar os pré-requisitos, campos de cliente necessários, passos de configuração e experiência do cliente.

Ligação de autoatendimento / QR

Páginas públicas de download

Ler Guia de Páginas de Download

Quando utilizar

Ideal para campanhas promocionais abertas, cartazes QR em loja, ligações na bio de redes sociais e banners de website onde qualquer pessoa pode obter um cartão.

Pré-requisitos

Modelo publicado com a Distribuição Pública ativada.

Campos de cliente necessários

Não são necessários dados prévios do cliente antes de partilhar o URL.

Configuração passo a passo

Abra Vista Geral do Modelo → Distribuição → Ativar Ligação Pública, copie o URL ou descarregue o código QR pronto a imprimir.

Experiência esperada do cliente

O cliente lê o código QR ou clica na ligação, acede à sua página personalizada com a marca e toca em Adicionar à Apple Wallet ou Google Wallet.

Detalhes práticos e comportamento da plataforma
  • A Importação em Massa CSV cria registos de cartões e URLs de download únicos no seu espaço de trabalho; não envia e-mails automaticamente salvo se iniciar uma campanha de Envio.
  • As Páginas de Download públicas e os formulários PassFlow podem ativar opcionalmente sobreposições guiadas PassTour para que novos utilizadores vejam como tocar em Adicionar e onde ficam as ofertas no verso do cartão.
  • O e-mail só é obrigatório ao enviar campanhas por e-mail ou verificação OTP por e-mail; a entrega por SMS, cartazes QR e ligações diretas funcionam sem e-mail.
Resolução de problemas nesta fase

A importação CSV falha ou ignora linhas durante o carregamento

Certifique-se de que o ficheiro está codificado em UTF-8, os nomes dos cabeçalhos das colunas correspondem às Propriedades Personalizadas do modelo e os campos de contacto obrigatórios estão preenchidos.

Os clientes comunicam que uma ligação de download partilhada indica «Distribuição Encerrada»

Verifique Vista Geral do Modelo → Controlos de Distribuição para confirmar que a distribuição está Ativada, a data de expiração não passou e o limite máximo de cartões não foi atingido.

06
Fase 6 de 6

Monitorize e gira

Monitorize a adoção da Carteira em tempo real, filtre segmentos de titulares, envie atualizações ou notificações push em direto e mantenha a operação.

Pré-requisitos antes de iniciar esta fase

  • Cartões distribuídos ativos nas Carteiras dos clientes (Fase 5)
  • Acesso ao Painel do Studio, Analítica do Modelo e Registo de Atividades

Instruções passo a passo

  1. 1

    Monitorizar taxas de Emitidos vs. Instalados vs. Removidos da Carteira

    Consulte os cartões Saúde do Passe no Painel e o separador Analítica do Modelo para acompanhar a conversão de instalações, dispositivos ativos e repartição por plataforma (iOS vs. Android).

  2. 2

    Filtrar titulares e inspecionar o Registo de Atividades

    Utilize os Filtros Avançados no diretório Passes para segmentar titulares por estado, nível da mecânica, saldo ou etiqueta, e audite cada leitura ou atualização no Registo de Atividades.

  3. 3

    Enviar atualizações em direto para cartões individuais ou grupos

    Edite atributos de um titular, execute uma ação em lote ou publique uma atualização de modelo para enviar novos saldos, níveis ou mensagens promocionais às Carteiras instaladas.

  4. 4

    Utilizar a Central de Ajuda ou Contactar o Suporte ao escalar problemas

    Consulte a Central de Ajuda de 10 Áreas para guias técnicos aprofundados e documentação de API/Webhooks, ou contacte o Suporte Passinstance indicando o ID do Cartão afetado.

Resultado esperado

Tem visibilidade total sobre a adoção na Carteira, leituras de resgate e atualizações do ciclo de vida dos clientes em todo o seu programa ativo de cartões.

Foco ampliado da interface1 / 5
Elementos-chave da interface

Painel Principal — KPIs ao vivo e Tendências (Ampliado)

Com o fluxo no ar, monitore Active in Wallets, Removed, Not Installed além das curvas de criação e registro.

Detalhes práticos e comportamento da plataforma
  • A faturação Passinstance e as métricas de utilização ativa contabilizam registos ativos na Carteira (cartões atualmente instalados nos dispositivos dos clientes), e não linhas brutas importadas por CSV.
  • Quando um cliente elimina um cartão da Apple Wallet ou Google Wallet, a plataforma recebe um aviso de cancelamento de registo e atualiza o estado do cartão para Removido.
  • Os programadores podem automatizar tudo nas Fases 3–6 através da API REST da Passinstance e Webhooks assinados (/docs).
Resolução de problemas nesta fase

O número de Emitidos é elevado, mas o número de Instalados na Carteira mantém-se baixo

Ative sobreposições guiadas PassTour no PassFlow e assegure que o botão CTA no seu e-mail/SMS abre a ligação do cartão diretamente no navegador móvel do cliente.

Precisa de revogar ou substituir o cartão comprometido de um cliente

Abra o registo do cartão em Studio → Passes, defina o estado como Anulado/Expirado ou elimine-o, e emita uma ligação de cartão de substituição para o cliente.

Auto-verificação pré-lançamentoLista de verificação manual guardada no seu navegador — não inspeciona dados em direto do espaço de trabalho

Pronto para lançar?

Verifique estes sete pontos observáveis num cartão de teste real antes de enviar cartões aos seus clientes.

0 / 7 verificados

Regra de ouro operacional

Teste e valide sempre um cartão real antes de lançar uma campanha de distribuição.

Guia Studio IA em Destaque

Criar Cartões Wallet com IA: Prompt, Importação e Assinatura

Use o ChatGPT, Claude ou Gemini para gerar pacotes de design .pkpass não assinados, detetar tokens dinâmicos automaticamente no Studio e assinar cartões com segurança na emissão.

Guia de onboarding em destaque

PassTour: Sobreposições guiadas para Adicionar à Wallet e 1.º uso

Saiba porque os guias temporários evitam dúvidas ao guardar o passe, revelam onde estão as ofertas e como configurar o Passo 1 e Passo 2.

Guia de Fidelidade em Destaque

Regras de progressão: Pontos, níveis e upgrades automáticos

Descubra por que níveis dinâmicos substituem modelos duplicados e como configurar limites, contraste WCAG, imagens Wallet e alertas push.

Guia de selos em destaque

Regras de coleção de selos: grelhas, proteção e prémios

Descubra por que razão as regras de selos substituem exportações manuais e como configurar validação, grelhas 3-5 colunas, ícones 720 x 720 px e proteção duplicada.

Orientação interativa do painel

Explore a interface do Passinstance Studio

Clique em qualquer marcador numerado nas vistas ampliadas abaixo para inspecionar os controlos e saltar diretamente para a fase de integração correspondente.

Foco ampliado da interface
Elementos-chave da interface

Painel do Workspace — KPIs e Tendências ao vivo

Acompanhe instalações ativas, remoções, cartões aguardando instalação e curvas de emissão e registro em 30 dias.

Todas as 10 áreas · 94 guias

Explorar por tópico

Explore guias passo a passo, documentação técnica e recursos de suporte.

94 guias encontrados
Área 28 guias2

2. Soluções e casos de uso

Descubra como aplicar cartões digitais Wallet a diferentes modelos de negócio.

Área 315 guias9

3. Criação e gestão de passes

Desenhe, emita, organize e mantenha os seus cartões digitais Wallet.

Área 410 guias3

4. Distribuição e envolvimento

Entregue cartões aos clientes e mantenha as carteiras sempre atualizadas.

Área 66 guias3

6. Validação e resgate

Valide passes, controle entradas e processe recompensas de clientes.

Área 710 guias

7. Integrações e automação

Ligue a Passinstance aos seus sistemas atuais e automatize processos.

Área 85 guias3

8. Análises e relatórios

Acompanhe o desempenho, atividade e adoção dos seus passes.

Área 916 guias

9. Conta e gestão empresarial

Gerencie organização, utilizadores, subscrição e definições fiscais.

Área 107 guias1

10. Ajuda e suporte

Encontre respostas, resolva falhas e contacte a equipa de suporte.

Perguntas frequentes

Perguntas frequentes

Não para fluxos self-service. O registo de conta aceita qualquer e-mail válido, e páginas públicas de transferência, códigos QR e links PassFlow permitem instalar o cartão sem dados prévios. O e-mail ou telemóvel só são necessários para Sendouts por E-mail/SMS ou verificação OTP opcional.

Sim. Cada novo espaço de trabalho inclui automaticamente um Certificado Apple de Demonstração e um Emissor Google Wallet gerido para testar imediatamente num telemóvel real. Antes do lançamento ao público, carregue o seu certificado Apple Pass Type ID (.cer) em Definições → Wallet (ou Ferramentas de Programador → Certificados).

Explorar por tema

Guias de implementação de carteira por caso de utilização

Navegue das etapas de configuração para os guias, documentação, artigos e casos de sucesso adequados ao seu tipo de programa.

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.