Guia da Shopify passo a passo
Da conexão da sua loja a um cartão de fidelidade no Apple Wallet e no Google Wallet dos seus clientes: checkout online, páginas do pedido e Shopify POS. Atualizado em 2026-11-19. Também em inglês e em francês.
O que você terá no final
- Sua loja Shopify conectada ao Pass Studio: os pedidos pagos chegam ao Pass Studio automaticamente.
- Um cartão de fidelidade (carimbos, pontos, pontos e níveis, ou créditos pré-pagos) que seus clientes guardam no Apple Wallet ou no Google Wallet, e que se atualiza no celular quando eles acumulam.
- O cartão oferecido na página que o cliente vê logo após pagar (a página Thank you da Shopify) e na página Order status.
- No caixa (Shopify POS): um bloco Pass Studio que lê o cartão do cliente, e uma linha Display QR Code após a venda que mostra o QR do cartão ao cliente.
Do que você precisa: uma loja Shopify, uma conta Pass Studio (gratuita, em www.thepassstudio.com) e, para a etapa 4, o Shopify POS em qualquer assinatura (POS Lite ou POS Pro). Os rótulos do admin da Shopify estão citados em inglês; se o seu admin da Shopify estiver em português, os mesmos itens estão nos mesmos lugares, traduzidos pela Shopify.
Etapa 1. Conectar sua loja
- Entre no Pass Studio em www.thepassstudio.com.
- Clique no seu avatar (no canto superior direito), depois em Configurações e em Integrações na barra lateral.
- Clique na linha Shopify para abri-la.
- Digite o domínio da sua loja, por exemplo
minhaloja.myshopify.com(ele aparece na barra de endereço do seu admin da Shopify). - Clique em Conectar com a Shopify. A Shopify abre e pede que você aprove o app: clique em Install app.
- Você volta ao Pass Studio. A linha Shopify mostra sua loja com um selo verde Conectado e, em O que está ativado, ✓ Emissão automática de cartões na compra (webhook ativo).
- Nada para copiar: nenhum token de API e nenhum webhook para criar. A conexão registra para você o webhook
orders/paidda Shopify. - Instalar pela Shopify App Store também funciona: clique em Install na página do Pass Studio; sem conta no Pass Studio, você chega à página de cadastro, e a loja se conecta assim que a conta existe.
- Uma loja, uma conta: uma loja fica conectada a uma única conta Pass Studio por vez. Se ela já pertence a outra conta, as Configurações mostram o titular atual, e a loja só muda de conta depois de um clique em Assumir esta loja.
- Equipes: a loja pertence ao contexto escolhido no seletor de equipe no momento da conexão. Conecte com a sua equipe selecionada para que todos os membros a vejam e os pedidos sejam cobrados da carteira da equipe.
- Se você vir um painel Set up auto-issue on purchase no lugar da linha ✓, o registro automático não terminou: siga o painel, ou as etapas manuais da página Shopify Setup (em inglês), e clique em Atualizar.
Etapa 2. Criar o cartão de fidelidade
- Abra Fidelidade no menu do Pass Studio e clique em + Novo programa. (O mesmo assistente abre em Cartões → + Novo cartão → Fidelidade, depois de dar um nome ao cartão.)
- Primeira pergunta: Primeiro, vamos entender que tipo de passe você quer criar. Escolha Criar um programa de fidelidade. (Cartão de membro cria um cartão de membro com níveis e pontos opcionais; Já tenho um programa de fidelidade é para Smile, Yotpo, LoyaltyLion ou o seu próprio sistema, que guardam o saldo.)
- Que tipo de programa você tem em mente? Escolha:
- Cartão de carimbos: um carimbo por visita, uma recompensa com o cartão cheio.
- Pontos: pontos por visita ou por valor gasto, uma recompensa ao atingir um limite.
- Pontos e níveis: pontos e níveis como Prata e Ouro.
- Créditos pré-pagos: o cliente compra um pacote e o consome (lavagens, aulas, pizzas, bebidas).
- Responda às outras perguntas curtas. Para pontos: Como os membros ganham pontos? Por visita ou Por valor gasto; depois o bônus de boas-vindas e Foto do membro no cartão?
- Enviar o cartão automaticamente após uma compra? Escolha Sim. É isso que faz um pedido pago da Shopify emitir o cartão. Em seguida o assistente pergunta quais pedidos: todos, ou só os que contêm os produtos escolhidos, e se deve convidar por e-mail os clientes atuais da loja quando o cartão for publicado.
- Passe pelas etapas de detalhe (regra de acúmulo, recompensa e, para créditos pré-pagos, os pacotes e os produtos da Shopify que os vendem) e pela revisão, e crie o programa.
- O assistente mostra Seu programa está pronto. Desenhe o cartão e depois publique. Clique em Ir para o cartão, adicione seu logo e suas cores no Studio e clique em Publicar. Os rascunhos são gratuitos. Publicar custa 10 créditos.
- Mudar depois os pedidos que emitem o cartão: Configurações → Integrações → Shopify → Configurar ou alterar a emissão automática, ou no próprio cartão: Studio → Jornada & distribuição → aba Compartilhar → Envio automático na compra (chave Enviar este cartão automaticamente por e-mail na compra e campo Buscar seus produtos…). Nenhum produto escolhido: todos os pedidos pagos.
- O e-mail de convite: quando um pedido pago corresponde ao cartão, um cliente que ainda não tem cartão recebe um e-mail do Pass Studio para se cadastrar; um cliente que já tem um cartão ativo não recebe um segundo. O endereço usado é o e-mail do pedido, senão o e-mail de contato, senão o e-mail do cliente vinculado ao pedido.
- Um cartão por cliente: cada cliente tem um único cartão de fidelidade ativo por loja. Um pedido nunca oferece um segundo cartão de fidelidade a quem já tem um.
- A recompensa no checkout: uma recompensa desbloqueada se aplica sozinha ao pedido de um cliente conhecido (chave Aplicar a recompensa automaticamente quando o cliente é conhecido, ligada por padrão). Detalhes em Automatic loyalty reward (em inglês).
Etapa 3. Mostrar o cartão nas páginas do pedido
Esta etapa coloca o bloco Pass Studio wallet buttons na página Thank you da Shopify (logo após o pagamento) e na página Order status (o pedido na conta do cliente). A Shopify deixa o layout do checkout com o lojista: um app não pode colocá-lo por você. Leva dois minutos, uma única vez.
- No admin da Shopify, vá em Settings → Checkout.
- Em Configurations, clique em Edit na configuração da sua loja. O editor de checkout abre na página Checkout.
- No seletor de página no topo do editor, escolha Thank you.
- Na seção Order summary, clique em Add block e escolha Pass Studio wallet buttons.
- No mesmo seletor, escolha Order status. Em Main, clique em Add block e escolha Pass Studio wallet buttons.
- Clique em Save. Os blocos não ficam no ar antes de salvar.
O que o seu cliente vê, sob o título Your purchase comes with a card:
- Um cliente sem cartão vê Add your card to your wallet. O botão abre o formulário de cadastro do cartão com o e-mail e o telefone do pedido já preenchidos e bloqueados; o cartão fica vinculado a esse cliente da Shopify.
- Um cliente que tem o cartão vê Add to Apple Wallet e Save to Google Wallet desse cartão, em todo pedido: um cartão que nunca foi adicionado, ou que foi removido do celular, pode ser adicionado de novo.
- O primeiro pedido conta: quando o cartão acumula pontos em pedidos, o pedido a partir do qual o cliente se cadastra é creditado no novo cartão, uma única vez. Usar o e-mail e o botão nunca conta o pedido duas vezes.
- Quais pedidos mostram o bloco: pedidos com um produto de um pacote pré-pago; pedidos que correspondem a um cartão com emissão automática (etapa 2); pedidos que emitiram um cartão próprio, como um cupom ou um ingresso. Qualquer outro pedido mostra os botões do cartão que o cliente já tem, e nada a um cliente sem cartão.
- Tempo: logo após o pagamento, o bloco mostra Preparing your wallet card… por até 30 segundos, enquanto a Shopify termina o pedido.
- Na pré-visualização do editor, o bloco mostra uma linha de espera: o pedido de exemplo não é um pedido real. Confira com um pedido de teste real (etapa 5).
- Idioma: o título e o botão do bloco estão em inglês.
Etapa 4. Configurar o Shopify POS
Duas configurações, as duas no admin da Shopify (não no aparelho do POS), uma vez por loja. Funcionam no POS Lite e no POS Pro.
4a. Adicionar o bloco Pass Studio (ler um cartão no caixa)
- No admin da Shopify, abra o canal de vendas Point of Sale → Customize your POS experience → Open editor.
- Na grade, clique em Add tile em uma página e escolha Pass Studio (busque ou role a lista se ele estiver mais abaixo).
- Clique em Save. O layout é sincronizado em todos os aparelhos POS do local; se o bloco não aparecer em um minuto, saia do app POS e entre de novo.
4b. Ativar o QR após a venda
- No mesmo editor do POS, abra o ícone Apps → Pass Studio.
- Ative Activate on: Post-purchase.
- Clique em Save. Sem isso, a linha Display QR Code não aparece após a venda.
No caixa
- O cliente mostra o cartão: toque no bloco Pass Studio, leia o cartão (ou digite o código de membro) e toque em Attach & apply discount. O cliente é vinculado à venda e o código da recompensa ou do cupom é aplicado; conclua a venda normalmente e os pontos chegam ao cartão.
- Nenhum cliente na venda: quando o carrinho tem itens e nenhum cliente, o bloco fica destacado e mostra No customer on this sale · Add the customer. Uma venda só credita quando há um cliente nela: leia o cartão, ou vincule o cliente com a busca de clientes da própria Shopify.
- Após uma venda com um pacote pré-pago: toque em Display QR Code na tela de venda concluída. A tela mostra o nome do cartão, os créditos comprados e um QR code. O cliente lê o código com a câmera do celular e recebe o cartão com os créditos. O mesmo QR continua no pedido: POS → Orders → o pedido → Display QR Code; um QR lido duas vezes nunca adiciona os créditos duas vezes.
- Após qualquer outra venda, o mesmo QR permite que um cliente sem cadastro participe. Quando a venda não tem pacote pré-pago e corresponde a um cartão de fidelidade com emissão automática (etapa 2), Display QR Code mostra um QR desse cartão, com ou sem cliente vinculado à venda. Sem cliente vinculado: o cliente lê o QR com a câmera do celular, preenche o formulário de cadastro do cartão (só os campos que você tornou obrigatórios são pedidos) e adiciona o cartão à carteira. Se o cartão acumula em pedidos, os pontos ou o carimbo dessa venda estão no novo cartão, contados uma única vez, e o cliente passa a aparecer na aba Titulares do cartão. Quando a venda traz o e-mail ou o telefone do cliente, o formulário abre com eles já preenchidos.
- Um cliente que já tem um cartão (o bloco leu o cartão na venda, ou o cliente vinculado à venda tem um) recebe o QR desse cartão: ler o código abre o cartão, ou o adiciona de novo ao celular. Nenhum segundo cartão é criado, e a venda já creditou o cartão.
- Quando não há QR: a tela responde This sale has no package for a card. quando a venda não tem pacote pré-pago e nenhum cartão de fidelidade é emitido nela: a emissão automática está desativada para o cartão, ou o cartão está limitado a produtos que não estão na venda. Uma venda que não foi totalmente paga, ou que foi reembolsada, não adiciona pontos no cadastro.
- Conferir a configuração: Configurações → Integrações → Shopify → Configurar leitura no PDV mostra POS não configurado, POS parcialmente configurado ou POS configurado, conforme o que os seus aparelhos POS informam. O estado muda depois que o POS é aberto com o bloco, ou depois de uma venda em que a linha do QR apareceu. Uma loja sem venda no POS nos últimos 60 dias mostra POS não utilizado.
- Consultar um cartão no caixa é gratuito. Os pontos e os resgates são contados a partir do pedido pago, como nos pedidos online.
Etapa 5. Testar
- Online: faça um pedido na sua loja com um e-mail que você lê, de um produto que corresponde ao cartão. Na página Thank you, o bloco mostra Your purchase comes with a card. Toque no botão, preencha o formulário e adicione o cartão à sua carteira.
- No Pass Studio, abra a aba Titulares do cartão: o novo titular está lá e, se o cartão acumula em pedidos, os pontos do pedido de teste estão nele.
- No caixa: comece uma venda, toque no bloco Pass Studio e leia o cartão que você acabou de adicionar. O cliente é vinculado à venda.
- Créditos pré-pagos: venda um produto de pacote no POS, toque em Display QR Code e leia o QR com um celular.
- Cliente sem cadastro: registre uma venda no POS sem cliente vinculado, de um produto que corresponde ao cartão. Toque em Display QR Code, leia o QR com um celular que ainda não tem o cartão e preencha o formulário. O novo titular aparece na aba Titulares do cartão, com os pontos da venda.
Perguntas frequentes
- Preciso criar um webhook na Shopify? Não. A conexão da loja já o registra. Só se as Configurações mostrarem o painel Set up auto-issue on purchase você o adiciona à mão, seguindo esse painel.
- O bloco não está na minha página Thank you. Ele não aparece até você adicioná-lo e clicar em Save no editor de checkout (etapa 3). Adicione-o nas duas páginas: Thank you e Order status.
- O bloco diz "Your card is not ready yet". A Shopify levou mais de 30 segundos para terminar o pedido. Ao abrir a página de novo um minuto depois, o cartão aparece.
- O bloco Pass Studio não está no POS. Adicione-o pelo admin da Shopify (etapa 4a), não pela janela Add tile do próprio aparelho, que muitas vezes não lista blocos de apps novos. Espere alguns minutos depois de instalar o app.
- Não há Display QR Code após a venda. Ative Activate on: Post-purchase (etapa 4b). Se a linha aparece e responde This sale has no package for a card., a venda não tinha nenhum produto de pacote pré-pago e não correspondia a nenhum cartão de fidelidade com emissão automática (etapa 2).
- Um cliente já tem um cartão. Ele vai receber um segundo? Não. Cada cliente tem um único cartão de fidelidade ativo por loja; as páginas do pedido mostram o cartão que ele tem.
- Funciona com Smile, Yotpo ou LoyaltyLion? Sim: na etapa 2, escolha Já tenho um programa de fidelidade. O cartão identifica o cliente no checkout e o seu app guarda o saldo. Veja Smile + Pass Studio.
- Quanto custa? Publicar um cartão custa 10 créditos; cada cartão emitido custa 1 crédito; processar pedidos é gratuito. Veja Billing (em inglês).
Para ir além
- Shopify Setup (em inglês): como a emissão decide, códigos de desconto, recompensa automática, webhook manual.
- Shopify Flow (em inglês): nove gatilhos e cinco ações nos eventos do cartão.
- Staff app (em inglês): ler cartões no balcão sem o Shopify POS.
Histórico: 2026-11-19 — guia publicado, substituindo o guia em PDF de 2026-06; cobre a conexão, o assistente de fidelidade, o bloco Pass Studio wallet buttons nas páginas Thank you e Order status (desde 2026-11-18 em todo pedido em que a loja emite um cartão) e o Shopify POS (bloco, e QR após a venda para pacotes pré-pagos). 2026-11-19 — o QR após a venda também serve um cartão de fidelidade emitido em pedidos: um cliente sem cadastro, sem cliente vinculado à venda, lê o código, participa, e os pontos da venda estão no novo cartão.