> 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.

# ¿Qué es la tarjeta wallet de tus clientes?

> La tarjeta wallet es el pase de Apple Wallet o Google Wallet que representa la membresía de cada cliente en tu programa. Muestra su saldo o progreso, sirve para identificarlo en el mostrador con un QR, y se actualiza solo cada vez que gana o canjea algo — sin que el cliente descargue ninguna app.

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

La tarjeta wallet es el pase de Apple Wallet o Google Wallet que representa la membresía de cada cliente en tu programa. Muestra su saldo o progreso, sirve para identificarlo en el mostrador con un QR, y se actualiza solo cada vez que gana o canjea algo — sin que el cliente descargue ninguna app. Tú personalizas el logo, el color y el banner del pase desde el CMS.

**TL;DR**

* El pase vive en el móvil del cliente (Apple Wallet o Google Wallet) y muestra su saldo/progreso, contador de visitas y un QR de identificación.
* Se actualiza automáticamente al cambiar el saldo o los sellos — sin acción del cliente.
* Personalizas logo (SVG con fondo transparente recomendado), colores y banner desde el CMS.
* Disponible en tienda física y Shopify: es el mismo pase, no una versión distinta por canal.

***

## Cómo funciona

1. El cliente se da de alta en tu programa y recibe un enlace para añadir su pase a Apple Wallet o Google Wallet — en el registro web ya aparece el botón "Add to Apple Wallet" directamente.
2. El pase muestra el saldo (cashback) o el progreso (sellos) con una etiqueta personalizable — por ejemplo "ACUMULADOS" en cashback o "PREMIOS" en sellos — junto a un contador de visitas.

<img src="https://files.buildwithfern.com/perkss.docs.buildwithfern.com/cd863b25f1f989dbb9d09b561bac6b35ed2b12c9e4cea16a7e848b38ce477f45/docs/assets/capturas/pase-wallet-apple-google.png" alt="comparación visual del pase en Apple Wallet y Google Wallet" />

3. Cada pase incluye un QR que identifica al cliente: es lo que tu empleado escanea en el mostrador para reconocerlo y aplicar el programa. \[VERIFICAR: si existe también identificación por NFC además del QR — no aparece en los fact packs revisados]
4. En programas de sellos, la imagen del pase ES la propia tarjeta de sellos: se regenera automáticamente según el progreso del cliente.
5. Cuando cambia el saldo o los sellos, el pase se actualiza solo. En iPhone puede mostrar una alerta en la pantalla de bloqueo con el cambio (texto configurable); en Android, los mensajes al pase se ven con notificación y quedan visibles 7 días — más detalle en la página de notificaciones push del wallet.

<img src="https://files.buildwithfern.com/perkss.docs.buildwithfern.com/d2bad419dcd7783d6bad42fe4bfe79c89013fb27f8a8c741c616fadba7e3409a/docs/assets/capturas/wallet-personalizacion-cms.png" alt="pantalla de personalización del pase: logo, color y banner" />

> \[TIP] El pase no es solo una tarjeta: también puede saltar en la pantalla del cliente cuando está cerca de uno de tus locales (hasta 10 ubicaciones, texto configurable), y en el reverso incluye enlace al perfil del cliente, redes sociales, reseñas de Google, contacto y direcciones de tus locales.

## Tipos de programa y qué muestra el pase

|                     | Cashback                                                       | Sellos                                                                                               |
| ------------------- | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Qué muestra el pase | Saldo acumulado con etiqueta personalizable (ej. "ACUMULADOS") | Progreso con etiqueta personalizable (ej. "PREMIOS") y la imagen del pase ES la cuadrícula de sellos |
| Banner/imagen       | Una foto que tú eliges                                         | Cuadrícula de sellos autogenerada según el progreso del cliente                                      |
| Para quién          | Negocios con programa de cashback (física o Shopify)           | Negocios con programa de sellos (hoy, solo tienda física)                                            |

## Qué configuras tú

| Ajuste                            | Qué hace                                                       | Valores                                                                |
| --------------------------------- | -------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Logo                              | Imagen que aparece en el pase                                  | SVG con fondo transparente recomendado (aviso literal del CMS)         |
| Colores                           | Color de fondo y de texto del pase                             | Libres, definidos por ti                                               |
| Banner / imagen strip             | Imagen superior del pase                                       | En cashback: una foto; en sellos: la cuadrícula de sellos autogenerada |
| Hero image (Google Wallet)        | Imagen destacada en el pase de Google                          | Libre, equivalente al banner de Apple                                  |
| Etiqueta del saldo (rewardsLabel) | Texto que acompaña el número de saldo/progreso                 | Ej. "ACUMULADOS", "PREMIOS" — editable                                 |
| Textos de notificación            | Mensaje al cambiar el saldo y mensaje de proximidad a un local | Editables, texto libre                                                 |

## Comportamiento por canal

| Canal         | Cómo se identifica al cliente                       | Notas                                                                |
| ------------- | --------------------------------------------------- | -------------------------------------------------------------------- |
| Tienda física | QR del pase escaneado por el empleado               | \[VERIFICAR: si existe también identificación por NFC además del QR] |
| Shopify       | El pase se vincula al alta del cliente en tu tienda | Mismo pase wallet, mismo mecanismo de personalización desde el CMS   |

***

## Preguntas frecuentes

No caduca por tiempo, pero es de un solo uso: se invalida al usarlo, y pedir uno nuevo invalida el anterior. Si la descarga falla, el enlace no se quema y se puede reintentar.

Sí. Se recomienda formato SVG con fondo transparente, y además puedes definir los colores de fondo y de texto del pase.

La imagen del pase es la propia tarjeta de sellos, regenerada automáticamente según su progreso, junto con la etiqueta personalizable (ej. "PREMIOS") y el contador de visitas.

Se actualiza solo en cuanto cambia su saldo o sus sellos — en iPhone puede incluso avisar en la pantalla de bloqueo.

Sí. Es el mismo mecanismo de pase y de personalización desde el CMS — no hay una versión distinta por canal.

***

**Relacionados:** Personaliza la tarjeta wallet en física - Notificaciones push del wallet - Clientes e identidad - ¿Qué es el cashback en Perkss?