Tutorial: crear y publicar un programa de lealtad
Configura componentes, niveles y recompensas, inscribe un cliente y realiza una prueba auditada.
Crear el programa
Abre Clientes → Lealtad.
En Programa escribe el nombre y conserva Borrador mientras preparas las reglas.
Activa Puntos, Cashback, Visitas / sellos y Niveles según lo que ofrecerá el negocio.
Para puntos indica el importe base y los puntos otorgados; por ejemplo, $100 = 1 punto.
Para cashback captura el porcentaje. El dinero se acredita mediante el wallet; desactiva primero el cashback heredado del negocio para evitar que el motor nuevo lo omita.
Personalizar y probar la tarjeta Wallet
En Tarjeta digital abre el editor de Google o Apple Wallet.
Deja activo Usar automáticamente la identidad de LinkStar para comenzar rápido, o desactívalo para personalizar.
Elige uno de los veinte colores de la paleta y sube el logo desde tu dispositivo.
En Google elige el dato principal y agrega hasta cuatro datos visibles.
Escribe un mensaje de bienvenida y términos sencillos. Abre Más opciones sólo si necesitas imágenes adicionales, reverso o enlaces.
Guarda para después o abre una tarjeta de prueba.
Cuando estés conforme selecciona Publicar tarjeta; los pases existentes se actualizan sin alterar puntos ni compras.
Configurar niveles
Activa Niveles.
Edita Bronce, Plata y Oro o agrega los nombres que use el negocio.
Define el gasto mínimo y el multiplicador de puntos de cada nivel.
Ordena los umbrales de menor a mayor y guarda.
Agregar recompensas
Abre Recompensas y selecciona Agregar recompensa.
Elige el saldo que desbloquea el beneficio y captura el umbral.
Para un descuento selecciona Promotion V2 y elige una promoción activa existente.
Para puntos o crédito wallet captura el monto del bono. Usa Beneficio manual para una cortesía que el personal verificará.
Guarda el programa. Checkout seguirá siendo la fuente de verdad para aplicar promociones.
Inscribir y probar
Abre Miembros y selecciona un cliente.
Selecciona Inscribir. Si el cliente ya pertenece al programa no se crea otra cuenta.
Usa Ajustar puntos o Ajustar sellos, captura una cantidad y escribe un motivo claro.
Confirma el nuevo saldo. El historial conserva el usuario, motivo e importe; el saldo nunca se edita directamente.
Cuando la configuración esté lista cambia el estado a Activo.
Finaliza una venta con ese cliente desde web o móvil y espera el procesamiento del evento. Confirma puntos, sellos, nivel, cashback o recompensa según las reglas.
Cancela la venta de prueba y confirma que aparezcan las operaciones inversas y que la recompensa disponible quede revocada.
Publicar la tarjeta digital
En Programa activa Inscripción pública mediante LinkStar y cambia el programa a Activo.
Confirma que el negocio tenga una página LinkStar con slug; no necesita estar publicada para habilitar /walletpass.
Abre Tarjeta digital, copia la URL o descarga el QR para tu cartel.
Escanea el QR, escribe nombre, teléfono y correo; Marduko reconocerá automáticamente una cuenta existente por correo.
Elige WhatsApp o correo y verifica el código recibido.
Abre Rewards y confirma que el QR del miembro no contiene IDs ni datos personales.
Escanea la tarjeta desde Marduko para consultar el resumen. El escaneo no canjea recompensas.
Probar Google Wallet
Completa el alta del emisor en Google Wallet y autoriza la cuenta de servicio en la consola del proveedor.
Configura en el servidor el issuer ID y la cuenta de servicio: puede ser un JSON completo o las variables separadas de correo y llave privada. Estos secretos no habilitan la sección Loyalty; sólo conectan el proveedor.
Crea el programa y cambia su estado a Activo.
En Tarjeta digital selecciona Preparar clase en Google Wallet. Marduko mostrará el ID exacto confirmado por Google.
Activa la inscripción pública e inscribe al miembro que realizará la prueba.
Completa el OTP; Marduko preparará el objeto del miembro.
En Rewards selecciona el botón negro Agregar a Google Wallet y confirma el guardado en Google.
Realiza una venta y confirma que puntos y nivel se actualicen posteriormente sin afectar el cierre de la venta.
Configurar y probar Apple Wallet
Crea en Apple Developer un Pass Type ID exclusivo para Loyalty y descarga su certificado.
Configura APPLE_WALLET_LOYALTY_PASS_TYPE_ID, APPLE_WALLET_TEAM_ID, el certificado WWDR y las credenciales de firma de Loyalty en Vercel. La URL de actualización se deriva de NEXT_PUBLIC_LINKSTAR_URL.
Aplica la migración 202609040006_apple_loyalty_wallet_design.sql.
En Tarjeta digital abre Diseño de Apple Wallet, ajusta identidad, imagen y textos, y publica.
Abre Rewards desde un iPhone y selecciona Agregar a Apple Wallet.
Confirma que el pase muestre nombre del negocio, puntos, nivel, sellos y el QR del miembro.
Realiza una venta y confirma que la actualización llegue al pase sin afectar Checkout.