Pular para conteúdo

Solução de problemas

Use o sumário para ir direto ao seu problema, ou pesquise por uma palavra-chave.

Problemas com e-mails de cartões-presente

O destinatário não recebeu o e-mail do cartão-presente

Verifique estes itens na ordem:

  1. Pasta de spam/lixo eletrônico — peça ao destinatário que verifique, inclusive as abas Promoções e Atualizações. Os e-mails de cartão-presente às vezes acionam filtros de spam.

  2. Erro de digitação no e-mail — encontre o cartão na Gift cards sending queue (veja Solução de problemas com cartões-presente ausentes) e confira o endereço. Um único caractere errado faz o e-mail parar em outro lugar. O Gift Card Hero não consegue detectar um endereço errado, então um endereço digitado com erro continua mostrando Sent.

  3. Status da fila — a fila mostra Scheduled (aguardando a data de envio), Sending, Sent ou Failed. Failed significa que o Gift Card Hero desistiu depois de várias tentativas; clique no endereço de e-mail para corrigi-lo e salve, o que envia o cartão novamente.

  4. Envio agendado — se o comprador escolheu uma data de entrega futura, o status é Scheduled e nada é enviado até essa data.

  5. Domínio do remetente — se você envia pelo seu próprio domínio, verifique os registros SPF e DKIM. Um registro mal configurado pode fazer os e-mails caírem no spam ou serem descartados. Se os lembretes ou as notificações de resgate passam pelo seu próprio servidor de e-mail, verifique a conexão em Settings → Integrations.

  6. Envie novamente — abra o cartão-presente no admin da Shopify (Products → Gift cards) e use Resend Gift Card no bloco Gift Card Management. Você pode enviar para o cliente, para o destinatário, para o administrador da loja ou para qualquer endereço que digitar. Veja Bloco de administração do cartão-presente.

O e-mail do cartão-presente está com problemas de estilo

  1. Os clientes de e-mail costumam bloquear imagens externas por padrão. Se só as imagens estiverem faltando, o destinatário pode optar por exibi-las.
  2. Gere o modelo novamente em Settings → Email template e confira a pré-visualização que abre. Se ela estiver certa, mas o e-mail estiver errado no Gmail ou no Outlook, o problema está no cliente de e-mail. Mantenha o HTML personalizado simples e evite imagens de fundo em CSS; use tags <img>.
  3. Se você colou o modelo na notificação de cartão-presente da Shopify (Settings → Notifications → Customer notifications → Gift card created), cole por cima o modelo recém-gerado. Veja Modelos de e-mail.

O e-mail mostra código bruto, como {{ gift_card.code }}

O modelo no editor de notificações da Shopify tem um erro de sintaxe, então a Shopify exibe os marcadores em vez de substituí-los. As causas comuns são um }} ou %} faltando, ou um texto cortado ao colar. Gere o modelo novamente em Settings → Email template, copie-o e substitua o modelo de notificação inteiro na Shopify.

Cartões-presente ausentes

Se um cliente disser que não recebeu o cartão-presente, siga os passos em Solução de problemas com cartões-presente ausentes. Em resumo:

  1. Confirme que o cartão existe em Shopify admin → Products → Gift cards.
  2. Verifique o status dele na Gift cards sending queue (página inicial → Recent gift card queue → View full report).
  3. Corrija o endereço e salve, ou reenvie pelo bloco Gift Card Management.
  4. Se o cartão não puder ser reenviado, emita um substituto com Issue e-Gift card.

Widget de consulta de saldo

O widget não aparece na minha loja virtual

  1. O embed do app está desativado — na página inicial, veja App Blocks Status. Se o seu tema ativo mostrar Disabled, clique em Activate app embed, ative Gift Card Hero no editor de temas e clique em Save. Veja Instalação e configuração.

  2. O widget está desligado — abra Balance widget no menu de navegação à esquerda. Se a página mostrar Gift card balance widget is Disabled, clique em Enable. (Algumas lojas veem uma versão mais curta desta página, sem essa chave; nelas, o widget é controlado somente pelo embed do app.)

  3. Lugar errado — o widget fica na sua página de consulta de saldo (https://[your-store].myshopify.com/a/gifthero/balance) ou onde você adicionou <div class="sc-hero-checker-container"></div>. Ao adicionar esse código a uma página, use o modo HTML do editor (o botão <>), senão as tags aparecem como texto. Veja Widget de consulta de saldo.

  4. Cache — force a atualização da loja virtual (Ctrl+Shift+R, ou Cmd+Shift+R no Mac).

  5. Tema antigo — o Gift Card Hero mostra We support only manual install for Shopify theme 1.0 em temas anteriores ao Online Store 2.0. Clique em Contact support e nós ajudamos você a instalá-lo manualmente.

A consulta de saldo diz que não encontra meu cartão

A consulta de saldo procura cartões somente pelo código completo. Digitar os últimos quatro caracteres, ou um código parcial, não retorna nada. Peça ao cliente que digite o código inteiro que está no e-mail dele.

O widget mostra saldo ou status errado

Se um cliente acabou de gastar o cartão, recarregue a página e consulte novamente. Um cartão vencido mostra Expired on seguido da data, não "Active". Se os saldos estiverem sempre errados pelo mesmo valor, entre em contato com o suporte.

Problemas com código de cartão-presente

"Invalid gift card code" no checkout

  1. Erro de digitação — os códigos não diferenciam maiúsculas de minúsculas, mas cada caractere precisa estar correto. Confira o 0 (zero) contra a letra O e o 1 (um) contra a letra I.

  2. Cartão desativado — o cartão pode ter sido desativado. Verifique o status dele em Shopify admin → Products → Gift cards.

  3. Cartão vencido — confira a data de validade no cartão. Um código vencido não funciona mais.

  4. Cartão de outra loja — um cartão de outra loja Shopify que não esteja na sua rede Multiloja não funciona no seu checkout.

  5. Saldo zerado — um cartão totalmente usado não tem nada para aplicar.

  6. Moeda — um cartão emitido em outra moeda pode não ser aceito na sua. Confira Cross-currency redemption na aba E-Gift cards. Veja a FAQ.

Um código é recusado no POS, mas funciona online

Confira as configurações do POS em POS tools → Shopify POS. Se Allow only redeeming gift cards in POS estiver ativado, a equipe só pode usar os códigos para pagar, não para recarregá-los. Verifique também se o cartão não está vencido nem é de outra loja, conforme descrito acima.

Problemas no POS

O bloco do Gift Card Hero não aparece no Shopify POS

O bloco não é adicionado automaticamente. No app Shopify POS:

  1. Toque em Add tile.
  2. Acesse Apps.
  3. Selecione Gift Card Hero.
  4. Toque em POS UI Extension. (A opção App link também existe, mas está obsoleta.)
  5. Toque em Done.

As mesmas etapas estão em POS tools → Shopify POS no Gift Card Hero. Se o app não aparecer na lista, atualize o app Shopify POS para a versão mais recente e, no iPad, force o fechamento e abra-o novamente. Veja Integração com o POS.

Recarregar ou registrar não está disponível no POS

Em POS tools → Shopify POS, confira Disable balance reload functionality in Shopify POS app e Disable gift card registration in Shopify POS app. Se qualquer uma delas estiver ativada, a ação correspondente fica oculta para a equipe.

Erro "Failed to load" no bloco do POS

Isso geralmente significa que o dispositivo POS não consegue acessar o Gift Card Hero. Verifique:

  • O dispositivo está conectado à internet?
  • Um firewall ou filtro de conteúdo está bloqueando conexões de saída?
  • Funciona depois de trocar do Wi-Fi para a rede móvel (ou o contrário)?

Em um POS de terceiros, veja Cartões-presente em POS de terceiros (PWA).

Operações em massa

A operação em massa parece travada

Operações grandes rodam em segundo plano e podem levar um tempo, dependendo dos limites de taxa da Shopify.

  1. Abra a operação em Bulk actions e marque Autorefresh import jobs na página de resultados.
  2. Cada linha tem um status: Pending e In progress significam que ainda estão sendo processadas, Retrying significa um erro temporário e o Gift Card Hero tentará de novo, Success significa que terminou, e Failed significa que o Gift Card Hero desistiu. Clique em Failed para ver o erro.
  3. Uma operação em andamento não pode ser pausada nem cancelada. Se ela não avançar por muito tempo, entre em contato com o suporte com o link da operação.

As linhas do meu envio em massa aparecem como "Failed"

Clique no selo Failed da linha para ler o erro. Para Mass send, o Gift Card Hero verifica os endereços antes de começar e informa quais são inválidos. Em um CSV, a causa mais comum são espaços extras ou caracteres ocultos na coluna de e-mail, muitas vezes vindos do Excel. Abra o arquivo em um editor de texto, corrija-o e envie novamente somente as linhas com falha. Baixe a lista completa com Download results (csv).

O envio em massa foi concluído, mas alguns destinatários dizem que não receberam o e-mail

  1. Confira os resultados. As linhas marcadas como Success foram enviadas; peça a esses destinatários que verifiquem o spam.
  2. Servidores de e-mail corporativos costumam filtrar e-mails em massa de remetentes novos.
  3. Se você envia muitos e-mails de uma vez, certifique-se de que os registros SPF e DKIM do domínio do remetente estão configurados.

Análises

Meu painel mostra $0 em todas as métricas

  1. Permissão — a análise precisa de acesso a todo o histórico de pedidos. Se aparecer Additional permissions required, clique em Give the app additional scope e aprove na Shopify.

  2. Sincronização — as análises são criadas a partir de dados sincronizados. Clique em Sync Data na página Analytics e escolha Sync for period ou Sync for all time. Um banner mostra o progresso. Se a sincronização travar, você pode clicar em Cancel sync e tentar de novo.

  3. Intervalo de datas — confira o intervalo de datas no topo da página.

O aumento de vendas aparece como 0 ou muito baixo

O aumento de vendas é o valor que os clientes gastam além do valor do cartão-presente. Se cada cartão cobre o pedido inteiro, não há nada extra para contar. Isso é normal em pedidos de baixo valor ou em cartões de alto valor.

As análises de cartões-presente não incluem meu crédito de fidelidade da loja

O crédito de fidelidade é reportado na própria aba Loyalty & promotions da página Analytics, não nos totais de cartões-presente. Veja Análises de fidelidade.

Contato com o suporte

Se nenhuma das opções acima resolver seu problema, clique em Get help na página inicial, ou em Contact us no rodapé de qualquer página, e inclua:

  • O domínio da sua loja (.myshopify.com)
  • Uma descrição do que você esperava e do que aconteceu
  • Os últimos quatro caracteres do cartão-presente ou o link da operação em massa, se aplicável
  • Uma captura de tela das mensagens de erro

O tempo de resposta costuma ser de até 1 dia útil.