Entrar
.md

Shopify App

Um app Shopify completo — construído em Remix e Prisma — que adiciona o cashback Guper na sua loja com uma interface admin embutida pra operação contínua.

O que vem pronto

  • ✅ Dashboard de configuração — configure as credenciais Guper e o comportamento da storefront sem sair do Shopify Admin
  • ✅ Relatórios de cashback — veja acúmulo e resgate cumulativos
  • ✅ Gestão de clientes — combine clientes Shopify com pessoas Guper
  • ✅ Valores de cashback vindos do mesmo endpoint Acúmulo por pedido

Uma loja, uma organização

O app serve uma loja Shopify por instalação, e essa loja fica vinculada a uma organização Guper pelas credenciais que você cola no setup. O mapeamento loja → organização é o que mantém a integração multi-tenant.

Setup

  1. Instale o app na sua loja Shopify pela listagem de partners.
  2. No admin embutido, cole sua API Key e API Secret — veja Autenticação pra obtê-las.
  3. Escolha em quais páginas da storefront mostrar o bloco de cashback (Cart, Product, Checkout).
  4. Rode um smoke test contra o Sandbox antes de virar pra credenciais de produção.

API de customização na storefront

Assim que o app é instalado, o script da storefront publica um objeto global com os valores de cashback do carrinho atual. Qualquer snippet do tema, seção customizada ou template Liquid pode ler ele sem precisar parsear atributos do carrinho nem escutar eventos:

window.guper.cashback = {
  reward: 1.99,      // cashback que o cliente vai acumular neste carrinho
  redeem: 4.99,      // cashback sendo resgatado neste carrinho (0 pra visitantes)
  anonymous: false,  // true quando não há cliente logado
  currency: "BRL",   // código ISO da moeda da loja
}

O objeto atualiza a cada mutação do carrinho (add, change, clear) e zera quando o carrinho fica vazio. Leia ele depois do evento guper:cashback:applied no document — esse evento dispara quando os valores acabaram de ser recalculados pro carrinho atual.

Exemplo — mostrar um pill "Você vai ganhar X" num snippet do tema:

<div id="my-earn-pill" style="display:none"></div>
<script>
  document.addEventListener('guper:cashback:applied', () => {
    const c = window.guper?.cashback;
    if (!c || !c.reward) return;
    const pill = document.getElementById('my-earn-pill');
    pill.textContent = `Ganhe ${c.currency} ${c.reward.toFixed(2)}`;
    pill.style.display = 'block';
  });
</script>

Suporte

O time de integração está no WhatsApp 24/7 — +52 55 2328 5981.