Entrar
.md

Shopify App

Una app Shopify completa — construida en Remix y Prisma — que agrega el cashback de Guper a tu tienda con una interfaz admin embebida para la operación continua.

Lo que viene listo

  • ✅ Dashboard de configuración — configura las credenciales Guper y el comportamiento del storefront sin salir del Shopify Admin
  • ✅ Reportes de cashback — visualiza la acumulación y los canjes acumulados
  • ✅ Gestión de clientes — vincula clientes Shopify con personas Guper
  • ✅ Montos de cashback impulsados por el mismo endpoint Acumulación por pedido

Una tienda, una organización

La app sirve a una sola tienda Shopify por instalación, y esa tienda queda vinculada a una organización Guper mediante las credenciales que pegas durante el setup. El mapeo tienda → organización es lo que mantiene la integración multi-tenant.

Setup

  1. Instala la app en tu tienda Shopify desde el listado de partners.
  2. Desde el admin embebido, pega tu API Key y API Secret — consulta Autenticación para obtenerlas.
  3. Elige en qué páginas del storefront mostrar el bloque de cashback (Cart, Product, Checkout).
  4. Corre un smoke test contra el Sandbox antes de cambiar a credenciales de producción.

API de personalización en storefront

Una vez instalada la app, el script del storefront publica un objeto global con los valores de cashback del carrito actual. Cualquier snippet del tema, sección personalizada o plantilla Liquid puede leerlo sin necesidad de parsear atributos del carrito ni escuchar eventos:

window.guper.cashback = {
  reward: 1.99,      // cashback que el cliente acumulará en este carrito
  redeem: 4.99,      // cashback siendo canjeado en este carrito (0 para visitantes)
  anonymous: false,  // true cuando no hay cliente logueado
  currency: "MXN",   // código ISO de la moneda de la tienda
}

El objeto se actualiza en cada mutación del carrito (add, change, clear) y se reinicia a cero cuando el carrito queda vacío. Léelo después del evento guper:cashback:applied en document — ese evento se dispara cuando los valores acaban de ser recalculados para el carrito actual.

Ejemplo — mostrar un pill "Ganarás X" en un snippet del 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 = `Gana ${c.currency} ${c.reward.toFixed(2)}`;
    pill.style.display = 'block';
  });
</script>

Soporte

El equipo de integración está en WhatsApp 24/7 — +52 55 2328 5981.