Skip to content
GUIA STUDIO STAMP PASS

Regras de coleção de selos: cartões automáticos no Apple Wallet e Google Wallet

Substitua cartões de papel e imagens estáticas por grelhas dinâmicas de selos, proteção contra leituras duplicadas, ícones 720 × 720 px e ciclos automáticos após prémio.

1 a 50 selos por ciclo
Pausa anti-duplicação (minutos)
Grelha de 3 / 4 / 5 colunas
Repor, manter completo ou novo ciclo
Simulador interativo de selos
Apple Wallet4 × 2CR-00124 · 2030-12-31
Após conclusão do prémioCiclos concluídos: 0
Faixa Apple Wallet gerada a cada leitura

PORQUE SÃO NECESSÁRIAS REGRAS DE SELOS

Porque cartões de papel e imagens estáticas não escalam

As regras de Stamp Pass unem lógica de leitura, composição visual, limites diários e ciclos de prémio num único modelo verificável — sem erros ao balcão.

01

Os cartões de papel perdem-se ou ficam esquecidos antes do resgate

Cartões físicos ficam em carteiras enquanto carimbos a tinta não oferecem registo de auditoria, controlo anti-duplicação nem notificações push.

02

Manter artes manuais para 1/8, 2/8 até 8/8 selos é inviável

Sem compositor dinâmico de selos, mudar um ícone ou alterar o número de casas obriga a gerar todas as imagens de estado manualmente.

03

Leituras sem limites geram selos duplicados e prémios bloqueados

Sem limite diário, pausa entre leituras e regra de fecho de ciclo, a equipa pode carimbar duas vezes a mesma compra.

Sem regras automatizadas de selos
  • As imagens estáticas obrigam a reexportar cada alteração de contagem
  • Sem proteção contra leituras QR repetidas em horas de ponta
  • Controlo manual ao balcão para reiniciar o cartão ou abrir novo ciclo
  • Cartões desligados sem progresso no ecrã de bloqueio
Com as regras de selos da Passinstance
  • Compositor no servidor desenha em direto selos ganhos, vazios e prémio
  • Grelha configurável de 3, 4 ou 5 colunas com tamanho e contraste ao vivo
  • Proteção anti-duplicação (minutos), teto máximo e limite diário nativos
  • Fluxo automático pós-prémio: repor, manter completo ou novo ciclo

MECÂNICA DE COLEÇÃO E PRÉMIOS

Três comportamentos de validação e três modos de fecho

Quer adicione selos por compra, desconte saldos pré-pagos ou atualize por webhook de POS, as regras garantem todo o ciclo de vida.

Mais comum

Adicionar selos

Cada leitura validada soma Selos por validação ao cartão até atingir a meta de Selos necessários.

STAMP_CARD_ADD
Modo resgate

Deduzir selos

Cada leitura subtrai selos de um saldo pré-carregado ou acumulado, bloqueando qualquer descida abaixo de zero.

STAMP_CARD_DEDUCT
Manual / API

Sem alteração automática

A leitura valida o passe sem alterar o saldo; os ajustes são feitos explicitamente no Studio ou por API.

NO_AUTOMATIC_CHANGE

Após conclusão do prémio

Repor selos

Ao resgatar o prémio, o cartão volta a zero selos para que o cliente comece uma nova ronda no mesmo passe.

Manter completo

Mantém todas as casas preenchidas e marca o cartão como concluído — ideal para campanhas pontuais.

Iniciar novo ciclo

Inicia automaticamente um novo ciclo após o resgate enquanto regista os ciclos concluídos no histórico.

CONFIGURAÇÃO PASSO A PASSO

Como configurar regras de coleção de selos no Passinstance Studio

Siga estes seis passos em Stamp Pass -> Regras de coleção de selos e explore ambos os separadores do Studio.

1

Abrir Stamp Pass -> Regras de coleção de selos

No Passinstance Studio abra Pontos e níveis -> Stamp Pass (em Store Card, Cupão ou Bilhete com strip) para gerir Coleção e prémios, Wallet e recursos e Definições avançadas.

2

Escolher comportamento de validação e metas

Selecione Adicionar, Deduzir ou Sem alteração automática e defina Selos necessários (1–50), Valor inicial e Selos por validação.

3

Configurar prémio e ação após conclusão

Indique nome e descrição do prémio e selecione Repor selos, Manter completo ou Iniciar novo ciclo.

4

Desenhar a grelha em Wallet e recursos

Configure 3, 4 ou 5 colunas, tamanho do selo (36px–72px), alinhamento (Esquerda, Centro, Direita, Auto) e fundos automáticos.

5

Carregar ícones opcionais de selo e prémio (720 × 720 px)

Envie PNG/SVG transparentes da marca para selos ganhos e casa final de prémio, ou utilize os ícones padrão.

6

Ativar limites em Definições avançadas e testar

Ative o teto máximo, limite diário e proteção contra leituras duplicadas (5 min por omissão) antes de publicar.

DENTRO DO PASSINSTANCE STUDIO

Coleção e prémios — validação, meta e comportamento pós-prémio

1 / 2
Visão do painel1 / 2
Elementos-chave da interface

Coleção e prémios — validação, meta e comportamento pós-prémio

Configure o modo de leitura, 8 selos necessários, os campos do prémio e a ação após conclusão com pré-visualização imediata.

SAÍDA REAL NAS CARTEIRAS

Uma configuração de carimbos, renderizada com nitidez no Apple Wallet e Google Wallet

Carregue os ícones de carimbo uma só vez no Studio. O Passinstance gera automaticamente as faixas nativas no iPhone e os gráficos de destaque no Android em cada leitura.

Cartão de carimbos Apple Wallet

iOS · PassKit

Apresenta a faixa composta de carimbos acima do identificador de membro e da data de validade, com um código QR nítido.

Composição de faixa StoreCardAtualização imediata via APNs

Cartão de carimbos Google Wallet

Android · Loyalty API

Posiciona o código QR, o contador de carimbos, o ID de membro e a data de validade no topo, acompanhados da grelha de carimbos na base.

Sincronização do gráfico inferior de carimbosCódigo QR e contador em destaque

PROTEÇÕES E DEFINIÇÕES AVANÇADAS

Proteção de leitura, limites visuais e verificação de saldo

Ative Definições avançadas para evitar abusos ao balcão mantendo apresentação uniforme no Apple Wallet e no Google Wallet.

Intervalo 1–50 selos

Não ultrapassar selos necessários

Impede que leituras excedam o limite definido (`MAXIMUM_EXCEEDED`), mantendo a grelha do cartão limpa.

Padrão: 1× / dia

Controlo diário de validações

Desative múltiplas leituras por dia para limitar a 1 selo/dia ou ative para cafés de grande movimento.

Padrão: 5 minutos

Janela anti-duplicação

Pausa configurável em minutos (5 minutos por omissão) bloqueia leituras repetidas acidentais do mesmo passe.

3 / 4 / 5 colunas

Compositor determinístico de faixas Wallet

Calcula automaticamente as coordenadas das casas ativas, vazias e prémio no Apple Wallet e Google Wallet.

Controlos de layout

Controlo fino de forma, espaço e posição

Ajuste forma (círculo, quadrado, arredondado), espaçamento (2–24px), separação do fundo (0–60%) e filas.

Proteção atómica de saldo

Validação de saldo em modo dedução

No modo Deduzir selos, leituras sem saldo suficiente são rejeitadas em segurança com `INSUFFICIENT_BALANCE`.

PERGUNTAS FREQUENTES

Perguntas frequentes sobre regras de selos

Quantos selos suporta um Passinstance Stamp Pass?

Suporta 1 a 50 selos por ciclo (`Selos necessários`) e 1 a 10 selos por leitura, dispostos em 3, 4 ou 5 colunas no Studio.

Que tipos de passe suportam grelhas e ícones de selo?

As faixas visuais funcionam em Store Card, Coupon e Event Ticket tanto no Apple Wallet como no Google Wallet.

É obrigatório carregar ícones personalizados de selo e prémio?

Não, ambos os ficheiros são opcionais (recomendado PNG/SVG transparente 720 × 720 px); sem envio, o Studio gera ícones padrão.

Qual a diferença entre Repor selos, Manter completo e Iniciar novo ciclo?

Repor limpa o cartão após resgate; Manter completo preserva o cartão cheio; Iniciar novo ciclo abre de imediato a ronda seguinte.

Como evita a Passinstance selos duplicados ao ler duas vezes?

A proteção anti-duplicação bloqueia leituras repetidas durante os minutos definidos (5 min por omissão) junto ao limite diário opcional.

Crie o seu modelo Stamp Pass no Passinstance Studio

Comece gratuitamente, personalize a grelha 3/4/5 e os ícones 720 × 720 px e teste no Apple Wallet e Google Wallet.