Para actualizar un wallet pass, lo editas en tu herramienta de pases o a través de una API. Después, la plataforma redibuja la tarjeta en cada dispositivo donde está guardada, sin reinstalar nada. En Apple, el cliente ve una alerta en la pantalla de bloqueo solo en los campos que tienen un mensaje de cambio. En Google, la alerta propia de Google llega solo en tarjetas de lealtad, boletos de eventos y pases de abordar.
En América Latina, donde Android domina con alrededor del 85% de los teléfonos, cómo se comporta la actualización en Google Wallet importa tanto como en Apple Wallet, así que esta guía cubre las 2 plataformas lado a lado.
Este es el lado práctico de las actualizaciones. Para la mecánica de fondo, lee cómo funcionan las actualizaciones de wallet passes. Los ejemplos usan Wallet passes de Pushwoosh, donde cada pase está ligado a un User ID y se puede actualizar desde el constructor, una campaña o la API.
Qué puedes cambiar
Casi todo. En los pases de Apple Wallet en Pushwoosh puedes editar el nombre y la descripción del pase, los valores y etiquetas de los campos, los mensajes de cambio, los colores, el mensaje del código de barras, la expiración y el estado, las ubicaciones y los beacons. Las imágenes quedan fijas. En los pases de Google también puedes cambiar el logo y la imagen principal, el código de barras, los links y el link a la app.
1 cosa no cambia: el estilo o tipo de pase. Una tarjeta de tienda no puede convertirse en cupón, y una tarjeta de lealtad de Google no puede convertirse en oferta. Si el formato tiene que cambiar, emite un pase nuevo.
| Cambio | Ejemplo | Qué ve el cliente |
|---|---|---|
| Valor de un campo | Puntos de 120 a 180 | La tarjeta se redibuja, más una alerta si hay un mensaje de cambio |
| Fecha u hora | El evento pasa a las 20:00 | La tarjeta se redibuja, más una alerta si hay un mensaje de cambio |
| Puerta, asiento, andén | Puerta B12 a B20 | La tarjeta se redibuja, más una alerta si hay un mensaje de cambio |
| Colores (imágenes en Google) | Diseño de temporada para el Buen Fin | La tarjeta se redibuja, sin alerta |
| Ubicaciones | Abrió una sucursal nueva | Cambia la relevancia en la pantalla de bloqueo, sin alerta |
| Expiración o anulación | Terminó la membresía | La tarjeta se ve en gris o pasa a vencidos |
1 pase o todos a la vez
Cada pase en Pushwoosh pertenece a 1 User ID. Eso te da 2 formas de actualizar.
Actualizar 1 pase a la vez es el caso de todos los días: una compra cambia el saldo de 1 cliente, así que cambia la tarjeta de ese cliente. Casi siempre vas a automatizarlo con la API o con la sincronización de tags, en vez de hacerlo a mano.
El caso masivo es el programa completo: términos nuevos o un diseño de temporada para todos los holders, como una tarjeta especial para Hot Sale o CyberMonday. En Pushwoosh esto se hace con una Wallet Pass Campaign (campaña de wallet pass). Los campos marcados como compartidos se actualizan en cada pase emitido desde la campaña, los campos personales conservan los valores de cada cliente, y la campaña te muestra cuántos pases afecta un cambio antes de guardarlo.
En los pases de Google Wallet, los campos pueden contener tags de usuario. Pushwoosh llena los valores de los tags cuando crea el pase y los refresca en cada actualización, así que la tarjeta muestra lo que dice el perfil en ese momento. En una campaña, la sincronización de tags hace esto en las 2 plataformas sin editar nada: cuando cambia el tag detrás de un campo, el pase recibe el valor nuevo en la siguiente revisión, cada 60 minutos por defecto.
Mensajes de cambio: a quién interrumpes
No toda actualización tiene que interrumpir a alguien. Tú decides cuáles sí.
En Apple, le agregas un mensaje de cambio a un campo, por ejemplo “Tu puerta ahora es %@”. Cuando ese campo cambia, iOS muestra el mensaje en la pantalla de bloqueo. Los campos sin mensaje se actualizan en silencio.
En Google, el tipo de pase decide si Google envía su propia alerta sobre los campos que cambiaron: solo las tarjetas de lealtad, los boletos de eventos y los pases de abordar la reciben, y Google escribe el texto. En boletos de eventos y vuelos solo se activa cuando faltan menos de 3 horas para el inicio. Para cualquier tipo, puedes adjuntar en su lugar una notificación personalizada a la actualización, por API o desde una campaña. Google permite como máximo 3 notificaciones por pase en 24 horas, y después de eso el pase se actualiza en silencio.
Nuestra regla: alerta solo en cambios en los que el cliente tiene que hacer algo, como una puerta nueva, un horario movido o puntos por vencer. Un rediseño o una sucursal nueva nunca necesitan alerta. En una app FinTech o de e-commerce, piensa en “tu cashback ya está disponible”, no en “mira nuestro nuevo diseño”.
Los mensajes de cambio no son un canal de marketing
Es tentador colar una promoción en un cambio de campo. No lo hagas. Apple y Google solo permiten notificaciones relacionadas con el pase, como un saldo, un estado o un horario, y romper esa regla es la forma más rápida de que borren tu tarjeta.
Para promociones, llega a los mismos clientes por push en la app, email o SMS: cada pase vive en un User ID, así que su holder ya está en tu audiencia. Cuando los holders necesitan saber algo del pase en sí, como una recompensa lista, las opciones están en la documentación sobre mensajes a holders de pases.
Actualizar a través de la API
Cuando el cambio viene de tus propios sistemas, como un punto de venta, un motor de reservas o un registro de puntos, usa la API en vez del constructor. El flujo es el mismo en las 2 plataformas: identifica el pase, envía los valores nuevos y deja que la plataforma sincronice.
Los métodos y parámetros están en las referencias de la Apple Wallet PassKit API y la Google Wallet API.
Expirar, anular y restaurar
Los pases tienen un ciclo de vida, y cerrarlo bien importa tanto como empezarlo. Una tarjeta desactualizada en el wallet de alguien es peor que no tener tarjeta.
En Apple, define una fecha de expiración y el pase se ve en gris después de ella. También puedes marcar un pase como anulado, por ejemplo cuando se canjea un cupón. En Google, invalidar un pase lo mueve a los pases vencidos del cliente, y puedes volver a activarlo después. Borrar un pase de Google lo invalida en Google y elimina su registro en Pushwoosh.
Cuando una actualización no llega
4 causas explican la mayoría de los casos.
El certificado de Apple venció. Los pases de Apple se firman con tu certificado Pass Type ID, y cuando vence, los pases no se pueden firmar ni actualizar. Anota la fecha de renovación en un calendario el mismo día que lo subes.
El cliente eliminó el pase. Las actualizaciones solo llegan a los dispositivos donde sigue guardado.
La actualización llegó, pero sin alerta. En Apple, revisa que el campo tenga un mensaje de cambio. En Google, revisa el tipo de pase, la casilla Notify about changed fields (notificar sobre campos modificados) y el límite diario.
El cliente nunca agregó el pase. Un pase emitido que nunca se guardó no recibe actualizaciones. Vuelve a enviar el link de instalación.
Mantén cada pase al día con Pushwoosh
Pushwoosh actualiza pases nativos de Apple y Google Wallet desde el constructor, una campaña o la API, con cada pase ligado al mismo User ID que tus push, emails y SMS. Cambia 1 saldo o el programa completo, y elige qué cambios merecen una alerta.
Mantener informados a tus clientes tiene poco que ver con enviar más. Se trata de que la tarjeta en su wallet siempre esté bien.
