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.
1
Conectar a loja
Configurações → Integrações
2
Criar o cartão de fidelidade
Fidelidade → + Novo programa
3
Cartão nas páginas do pedido
Thank you + Order status
4
QR no caixa
Shopify POS
5
Cartão na carteira
Apple + Google Wallet
As cinco etapas deste guia. Conte com uns 20 minutos; as etapas 3 e 4 são feitas uma única vez, no admin da Shopify.

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

  1. Entre no Pass Studio em www.thepassstudio.com.
  2. Clique no seu avatar (no canto superior direito), depois em Configurações e em Integrações na barra lateral.
  3. Clique na linha Shopify para abri-la.
  4. Digite o domínio da sua loja, por exemplo minhaloja.myshopify.com (ele aparece na barra de endereço do seu admin da Shopify).
  5. Clique em Conectar com a Shopify. A Shopify abre e pede que você aprove o app: clique em Install app.
  6. 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).
ConfiguraçõesProfileIntegraçõesBillingTeamSShopifyDomínio da lojamystore.myshopify.comConectar com a Shopify1Smystore.myshopify.com● Conectado✓Emissão automática de cartões na compra (webhook ativo)▸Configurar leitura no PDV2
Configurações → Integrações → Shopify: digite o domínio e conecte (1); depois de conectada, o webhook de pedidos fica ativo (2).
  • Nada para copiar: nenhum token de API e nenhum webhook para criar. A conexão registra para você o webhook orders/paid da 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

  1. 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.)
  2. 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.)
  3. 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).
  4. 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?
  5. 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.
  6. 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.
  7. 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.
Que tipo de programa você tem em mente?
Cartão de carimbosUm carimbo por visita, uma recompensa com o cartão cheioPontosPontos por visita ou por valor gastoPontos e níveisPontos e níveis como Prata e OuroCréditos pré-pagosO cliente compra um pacote e o consome
Enviar o cartão automaticamente após uma compra?
SimNão3
O assistente de programa: escolha o tipo de programa e responda Sim ao envio automático do cartão após uma compra (3).
  • 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.

  1. No admin da Shopify, vá em Settings → Checkout.
  2. Em Configurations, clique em Edit na configuração da sua loja. O editor de checkout abre na página Checkout.
  3. No seletor de página no topo do editor, escolha Thank you.
  4. Na seção Order summary, clique em Add block e escolha Pass Studio wallet buttons.
  5. No mesmo seletor, escolha Order status. Em Main, clique em Add block e escolha Pass Studio wallet buttons.
  6. Clique em Save. Os blocos não ficam no ar antes de salvar.
Thank you▾1Save4SECTIONSHeaderOrder summary⊕ Add block2MainFooterAPPSPass Studio wallet buttons3Other app blockOther app blockPreviewPass Studiowallet buttons
Editor de checkout da Shopify: seletor de página em Thank you (1), Add block em Order summary (2), Pass Studio wallet buttons (3), Save (4). O mesmo em Order status, em Main.

O que o seu cliente vê, sob o título Your purchase comes with a card:

Thank you, Alex!Confirmation #A7K2QXYour purchase comes with a cardAdd your cardto your wallet ›New customerThank you, Alex!Confirmation #A7K2QXYour purchase comes with a cardAdd to Apple WalletSave to Google WalletCustomer who holds the card
À esquerda: um cliente sem cartão vê um botão que abre o cadastro com este pedido. À direita: um cliente que já tem o cartão vê os botões da carteira.
  • 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)

  1. No admin da Shopify, abra o canal de vendas Point of Sale → Customize your POS experience → Open editor.
  2. Na grade, clique em Add tile em uma página e escolha Pass Studio (busque ou role a lista se ele estiver mais abaixo).
  3. 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

  1. No mesmo editor do POS, abra o ícone Apps → Pass Studio.
  2. Ative Activate on: Post-purchase.
  3. Clique em Save. Sem isso, a linha Display QR Code não aparece após a venda.
Point of Sale · Customize your POS experienceSMART GRIDPass StudioScan coupon ormember pass⊕ Add tile1APPS › PASS STUDIOActivate onPost-purchase2Shows the Display QR Code rowafter a sale.Save3
Admin da Shopify → Point of Sale → editor do POS: o bloco Pass Studio na grade (1), Apps → Pass Studio → Activate on: Post-purchase (2), Save (3).

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.
✓Transaction completePrint receiptDisplay QR Code›1New saleCar Wash Club10 washes ×1 = 10 creditsAsk the customer to scan this codeto get the card with the credits.📱 Celular do cliente → Apple / Google Wallet2
No aparelho POS após a venda: Display QR Code (1) mostra o QR do cartão para o cliente ler (2). Exemplo: um pacote de 10 lavagens.
  • 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

  1. 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.
  2. 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.
  3. No caixa: comece uma venda, toque no bloco Pass Studio e leia o cartão que você acabou de adicionar. O cliente é vinculado à venda.
  4. Créditos pré-pagos: venda um produto de pacote no POS, toque em Display QR Code e leia o QR com um celular.
  5. 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.