# Diseñar pases de Google Wallet en el creador de pases

El creador de pases de Google Wallet es un diseñador visual en el Panel de Control. Eliges un tipo de pase, rellenas la marca, los campos y un código de barras, ves una previsualización en vivo y creas el pase. Cuando generas el pase, Pushwoosh crea el objeto del pase en Google Wallet y devuelve un enlace para guardar de "Añadir a Google Wallet".

## Crear un pase

<Aside type="note" title="Se requiere configuración previa">
El creador solo está disponible después de que Google Wallet esté configurado para la aplicación (ID de emisor y clave de cuenta de servicio). Si aún no está configurado, configúralo primero: [Configuración de pases de Google Wallet para Android](/es/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/).
</Aside> 

En el Panel de Control, ve a **Campañas → Pases de Wallet**, abre la pestaña de **Google Wallet** y haz clic en **Crear pase**.

<img src="/google-wallet-passes-pass-builder-1.webp" alt="Página de Pases de Wallet con la pestaña de Google Wallet abierta y el botón Crear pase visible"/>


## Configurar el pase

*   **Desde cero:** comienza con un pase vacío. Elige un tipo de pase, luego establece los campos, la apariencia, un código de barras y otras opciones tú mismo en las secciones siguientes.

*   **Desde una plantilla:** haz clic en **Cargar plantilla**, elige un pase predefinido en **Seleccionar Plantilla** (genérico, oferta, fidelización, entrada para evento, tarjeta de regalo, vuelo o transporte) y confirma. El formulario rellena previamente el tipo de pase, los campos, los colores y el código de barras. Edita cualquier valor o cambia el tipo según sea necesario.

### Elige un tipo de pase

En **TIPO DE PASE**, elige uno de los siete tipos de pase de Google Wallet. El tipo controla el diseño de la tarjeta y qué campos están disponibles. Los pases tipados usan el diseño nativo de Google. El pase genérico es de formato libre.

*   **Genérico:** tarjeta de formato libre con tus propios campos.
*   **Oferta:** cupones y descuentos.
*   **Tarjeta de fidelización:** tarjetas de fidelización y de membresía.
*   **Entrada para evento:** entradas para eventos.
*   **Tarjeta de regalo:** tarjetas de regalo y prepago.
*   **Vuelo:** tarjetas de embarque.
*   **Transporte:** billetes de tren, autobús, tranvía y ferry.



### Rellena los campos del pase

Los campos que ves dependen del tipo de pase. Los campos obligatorios están marcados. Campos comunes por tipo:

| Tipo de pase <div style="width:140px"></div> | Campos clave |
| :---- | :---- |
| **Genérico** | Título de la tarjeta*, Encabezado*, Subencabezado, campos de la tarjeta |
| **Oferta** | Título*, Proveedor*, Detalles, Letra pequeña, Canal de canje (en tienda / en línea / ambos), Nombre del emisor |
| **Fidelización** | Nombre del programa*, Nombre del miembro, ID del miembro, Saldo de puntos, Etiqueta de puntos, Nivel de recompensas, Etiqueta de nivel, Nombre del emisor |
| **Entrada para evento** | Nombre del evento*, Lugar, Dirección, Fecha y hora de inicio/fin, Titular de la entrada, Número de entrada, Tipo, Sección, Fila, Asiento, Puerta |
| **Tarjeta de regalo** | Nombre del comerciante*, Número de tarjeta*, PIN, Saldo + moneda |
| **Vuelo** | Código IATA de la aerolínea*, Número de vuelo*, Origen*, Destino*, Salida*, Nombre del pasajero*, Hora de embarque, Asiento, Clase, Grupo de embarque, Código de confirmación |
| **Transporte** | Tipo de transporte* (autobús / tren / tranvía / ferry / otro), Operador*, Pasajero*, Tipo de viaje, tramos del viaje (origen*, destino*, horas, andén, vagón, asiento) |

\* Requerido por Google.

<Aside type="note" title="Fechas y horas">
La mayoría de los tipos de pase usan ISO 8601 con un desfase UTC (por ejemplo, `2026-07-01T19:30:00+02:00`). Los pases de vuelo son una excepción: Google requiere que las horas de salida, embarque y llegada estén en la hora **local** del aeropuerto **sin** un desfase (por ejemplo, `2026-09-01T06:30:00`).
</Aside>

#### Personaliza el contenido del pase

Cada pase está vinculado a un [User ID](/es/product/pushwoosh-knowledge-hub/users-userids/). Usa marcadores de posición de tags para mostrar datos únicos de ese usuario, por ejemplo, un saldo de puntos en una tarjeta de fidelización o el nombre del destinatario en una tarjeta de regalo. Emite un pase por User ID para que cada destinatario obtenga sus propios valores.

Para insertar un marcador de posición de tag:

1.  Junto a un campo de texto compatible (por ejemplo, **Comerciante**, **Título de la tarjeta** o **Encabezado**), haz clic en `{}` para insertar un tag.
2.  En **TAG**, selecciona el [tag](/es/product/audience-data-and-segmentation/user-data-tags/tags/) para insertar en el campo.
3.  En **FORMATO**, elige cómo mostrar el valor del tag: **Tal cual** (usa el valor almacenado), **Entero** (redondea a un número entero), **Precio (0.00)** (muestra dos decimales) o **Poner en mayúscula la primera letra** (pone en mayúscula la primera letra).
4.  En **FALLBACK**, opcionalmente introduce un texto para mostrar cuando el destinatario no tiene un valor para el tag.
5.  Haz clic en **Insertar**.

<img src="/google-wallet-passes-pass-builder-2.webp" alt="Campo de pase con el diálogo Insertar un tag abierto, mostrando las opciones de Tag, Formato y Fallback"/>

Pushwoosh rellena los valores de los tags cuando creas el pase y los actualiza en cada actualización.


### Configura la apariencia

En **APARIENCIA**, configura los colores, las imágenes, quién puede guardar el pase y la caducidad.

#### Colores

Introduce un código hexadecimal en **Color de fondo**, por ejemplo `#FFFFFF` para blanco. Incluye el `#` inicial y seis caracteres.

#### Imágenes

<Aside type="caution" title="Aloja las imágenes en una URL HTTPS pública">
Google Wallet no almacena tu logotipo o imagen principal. Aloja cada archivo en una **URL HTTPS pública** que permanezca en línea y accesible, y luego pega el enlace en el creador de pases. Si la URL se rompe o el archivo se elimina, la imagen dejará de cargarse en el pase.
</Aside>

Pega un enlace HTTPS público en **URL del logotipo**. Requerido para pases de fidelización y transporte.

Opcionalmente, pega un enlace en **URL de la imagen principal** para un banner ancho debajo de los detalles de la tarjeta en el anverso del pase. El tamaño recomendado es 1032×336 px.

<img src="/google-wallet-passes-pass-builder-3.webp" alt="Sección APARIENCIA con campos de color de fondo, URL del logotipo, URL de la imagen principal, Quién puede guardar el pase y Fecha de caducidad"/>

<Aside type="tip" title="URLs del almacén de medios">
Puedes pegar una URL de imagen pública desde el [Almacén de medios](/es/product/content/media-store/), incluyendo una [variante](/es/product/content/media-store/#create-image-variants) dimensionada para la ubicación.

**Nota:** Si eliminas la imagen en el Almacén de medios, dejará de cargarse en el pase.
</Aside>

#### Quién puede guardar el pase

En **Quién puede guardar el pase**, selecciona quién puede añadir el pase a Google Wallet:

*   **Un usuario, todos sus dispositivos** (predeterminado): el pase está vinculado a una cuenta de Google y se sincroniza en todos los dispositivos de esa cuenta.
*   **Un usuario, un dispositivo:** el pase se guarda solo en un único dispositivo.
*   **Cualquiera con el enlace:** cada cuenta de Google que abra el enlace para guardar obtiene el mismo objeto de pase compartido. Cuando actualizas el pase, Google entrega el cambio a todos los poseedores automáticamente.

<Aside type="note" title="Cualquiera con el enlace">
Usa esto para pases donde todos los poseedores ven el mismo contenido, por ejemplo, una oferta para toda la tienda o una entrada para un evento público sin asiento asignado. Evítalo para tarjetas de fidelización, tarjetas de regalo o cualquier pase donde el contenido deba ser personalizado por usuario. Pushwoosh rastrea solo un dispositivo para el objeto compartido, por lo que los poseedores individuales no son visibles y no pueden ser segmentados por separado.
</Aside>

#### Caducidad

Establece la **Fecha de caducidad** para cuando Google deba caducar el pase, o déjalo vacío para que no caduque.

### Añade un código de barras

En **CÓDIGO DE BARRAS**, elige un formato e introduce el valor a codificar:

1.  **Formato:** elige cómo se ve el código de barras y qué tipo de escáner puede leerlo.
    *   **QR_CODE:** código cuadrado que la mayoría de los teléfonos y escáneres leen fácilmente. El mejor para la mayoría de los pases.
    *   **PDF_417:** código de barras ancho compuesto por varias filas de líneas. A menudo requerido para tarjetas de embarque.
    *   **AZTEC:** código cuadrado compacto, similar al QR. Común en entradas de eventos y transporte.
    *   **CODE_128** / **EAN_13:** códigos de barras 1D. Elígelos solo si tu escáner o sistema POS los requiere.
2.  **Valor:** los datos codificados en el código de barras (por ejemplo, un número de entrada o de membresía). Para usar un valor único por usuario, haz clic en `{}` junto al campo e inserta un [marcador de posición de tag](#personaliza-el-contenido-del-pase).
3.  **Texto alternativo:** texto que se muestra debajo del código de barras en el pase.

<img src="/google-wallet-passes-pass-builder-5.webp" alt="Sección CÓDIGO DE BARRAS con campos de Formato, Valor y Texto alternativo"/>

### Añade campos de detalles y enlaces

En el anverso del pase, los usuarios ven la tarjeta principal. Cuando abren los detalles del pase (el reverso), pueden leer secciones adicionales y tocar los enlaces que añadas aquí.

*   **Módulos de texto:** bloques de texto adicionales en el reverso del pase. Establece un **encabezado** (el título de la sección) y un **cuerpo** (el texto). Úsalos para términos, instrucciones u otra información que no quepa en el anverso.
*   **Enlaces:** enlaces táctiles en el reverso del pase. Establece una **URL** y una **descripción** corta (por ejemplo, "Localizador de tiendas" o "Términos y condiciones").

<img src="/google-wallet-passes-pass-builder-6.webp" alt="Secciones MÓDULOS DE TEXTO y ENLACES con campos de encabezado, cuerpo, URL y descripción"/>

### Añade un enlace a la aplicación *(opcional)*

En **ENLACE A LA APLICACIÓN**, añade un botón en el anverso del pase que abre una página web o tu aplicación de Android al tocarlo. Puedes establecer una **URL**, un **nombre de paquete de Android**, o ambos.

Si solo estableces la URL, el botón abre esa dirección web en cualquier dispositivo. Si solo estableces un nombre de paquete, el botón funciona en dispositivos Android que tengan la aplicación instalada, sin alternativa web.

<img src="/google-wallet-passes-pass-builder-4.webp" alt="Sección ENLACE A LA APLICACIÓN con campos de URL y nombre del paquete de Android"/>

### Añade ubicaciones *(opcional)*

En **Relevancia basada en la ubicación**, añade puntos de interés. Google muestra una notificación geocercada cuando el usuario está cerca de una ubicación que añades. Por ejemplo, muestra una tarjeta de fidelización cerca de tu tienda, una entrada de evento cerca del lugar, o una tarjeta de embarque cerca del aeropuerto.

Puedes añadir hasta **10** ubicaciones, cada una establecida por latitud y longitud.

<img
  src="/google-wallet-passes-pass-builder-7.webp"
  alt="Sección UBICACIONES con campos de latitud y longitud para añadir puntos de interés"
  style={{ maxWidth: "480px", width: "100%", height: "auto" }}
/>

<Aside type="note" title="Ubicaciones en Google Wallet">
Google controla el radio de la geocerca y decide cuándo mostrar la notificación. No puedes establecer una distancia máxima por ubicación.
</Aside>

### Introduce un User ID

Introduce el [User ID](/es/product/pushwoosh-knowledge-hub/users-userids/#how-are-users-and-devices-related) de Pushwoosh para la persona que recibirá este pase.

Pushwoosh emite el pase a ese usuario y lo lista bajo **USUARIO** en [**Todos los pases**](/es/product/messaging-channels/google-wallet-passes/#view-and-manage-existing-passes).

### Previsualiza y valida

Una **previsualización en vivo** se actualiza a medida que editas, para que puedas ver aproximadamente cómo se verá el pase en Google Wallet.

<Aside type="note" title="La previsualización puede diferir en un dispositivo">
La previsualización es una aproximación. Los pases tipados usan el diseño nativo de Google, por lo que el pase puede verse diferente en un dispositivo real. El código de barras que se muestra es un marcador de posición.
</Aside>

Para comprobar el pase con los requisitos de Google sin crearlo, haz clic en **Validar**. El creador marca los campos obligatorios que faltan y otros problemas.

## Genera el pase

Haz clic en **Generar**. Pushwoosh comprueba el pase y lo crea en Google Wallet. Obtienes un enlace para guardar de **Añadir a Google Wallet** para compartir con los usuarios. En pocos segundos, el pase aparece en [**Todos los pases**](/es/product/messaging-channels/google-wallet-passes/#view-and-manage-existing-passes).

Para editar, obtener el enlace para guardar, invalidar y eliminar pases después de su creación, consulta [Gestionar pases existentes](/es/product/messaging-channels/google-wallet-passes/#view-and-manage-existing-passes).

## Gestiona pases a través de la API

Todo lo que hace el creador de pases también está disponible a través de la [API de Google Wallet](/es/developer/api-reference/google-wallet-api/): crear, actualizar, listar, obtener un enlace para guardar, establecer el estado y eliminar pases.

<LinkCard title="API de Google Wallet" href="/developer/api-reference/google-wallet-api/" />