> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.perkss.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.perkss.io/_mcp/server.

# Solución de problemas

> Este hub reúne los problemas más frecuentes que nos reportan los comercios, agrupados por tema, con un enlace directo a la página que explica la solución. La idea es que encuentres tu caso en unos segundos, sin tener que leer toda la documentación.

> **Disponible en:** 🏬 tienda física · 🛍️ Shopify

Este hub reúne los problemas más frecuentes que nos reportan los comercios, agrupados por tema, con un enlace directo a la página que explica la solución. La idea es que encuentres tu caso en unos segundos, sin tener que leer toda la documentación.

**TL;DR**

* Busca tu síntoma por categoría (pase, saldo, widget, emails...) más abajo.
* Cada entrada te lleva a la página how-to o de FAQ que resuelve ese caso concreto.
* Si no encuentras tu problema aquí, escala a soporte (ver sección final).

## Busca tu problema

### El pase (wallet) no llega o no funciona

* El miembro no recibe el enlace de descarga del pase → consulta "Cómo se genera y se descarga el pase wallet".
* El pase no se actualiza tras una compra o canje → consulta "Por qué mi saldo no cuadra" y "Cómo se actualiza el pase wallet".
* El enlace de descarga da error al abrirlo por segunda vez → consulta "Cómo se genera y se descarga el pase wallet" (el enlace es de un solo uso).

### El saldo o los sellos no cuadran

* El saldo de cashback no coincide con lo esperado tras una venta o canje → consulta "Cómo funciona el cashback" y "Ajustes y correcciones".
* Los sellos no avanzan o no se resetean al completar la vuelta (solo tienda física; en Shopify v1 el programa de sellos aún no existe) → consulta "Cómo funciona el programa de sellos".
* Necesito corregir manualmente el saldo o los sellos de un miembro → consulta "Ajustes y correcciones".

### El widget no aparece en mi tienda (Shopify)

* El widget de fidelización no se ve en el storefront → consulta "Integración con el tema (widget)".
* El enlace directo a referidos u otra sección del widget no funciona → consulta "Integración con el tema (widget)".

### Los emails no salen o no llegan

* Los emails a miembros no se envían → consulta "Emails a tus miembros" (recuerda: solo puedes enviar con tu propio dominio verificado, sin remitente de Perkss por defecto).
* El email llega marcado como spam o no llega en absoluto → consulta "Emails a tus miembros".

### El alta de un miembro falla o duplica

* Un cliente no puede darse de alta o aparece duplicado → \[VERIFICAR: página de referencia sobre alta de miembros y sus vías, aún no confirmada en esta producción].

### Niveles VIP no se aplican (solo Shopify)

* Un descuento de nivel VIP no se aplica en el pedido → \[VERIFICAR: página de referencia sobre Niveles VIP, aún no confirmada en esta producción]. Recuerda que los Niveles VIP son un concepto exclusivo de Shopify; en tienda física este concepto no existe.

### Una recompensa desbloqueada no se puede canjear

* El miembro tiene una recompensa lista pero no se puede aplicar el canje → consulta "Cómo funciona el cashback" o "Cómo funciona el programa de sellos" según tu tipo de programa (recuerda que sellos es solo tienda física).

## ¿No lo has encontrado?

Si tu problema no está en esta lista, escribe a soporte de Perkss describiendo el síntoma, el local o tienda afectada y, si puedes, el nombre o teléfono del miembro implicado. El equipo de soporte revisa cada caso de forma individual.

Este hub está pensado para ampliarse con el tiempo: iremos añadiendo más categorías y enlaces a medida que detectemos nuevos problemas frecuentes. Si no aparece el tuyo hoy, puede que se incorpore más adelante.

**Relacionados:** Emails a tus miembros | Integración con el tema (widget) | Ajustes y correcciones | Cómo funciona el cashback