# 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. Usted elige un tipo de pase, completa la marca, los campos y un código de barras, ve una vista previa en vivo y crea el pase. Cuando genera el pase, Pushwoosh crea el objeto del pase en Google Wallet y devuelve un enlace para guardarlo 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úrelo 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, vaya a **Campañas → Wallet Passes**, abra la pestaña **Google Wallet** y haga clic en **Crear pase**.

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


## Configurar el pase

* **Desde cero:** comience con un pase vacío. Elija un tipo de pase, luego establezca los campos, la apariencia, un código de barras y otras opciones usted mismo en las secciones a continuación.

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

### Elegir un tipo de pase

En **TIPO DE PASE**, elija 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 con tipo utilizan el diseño nativo de Google. El pase genérico es de formato libre.

* **Genérico:** tarjeta de formato libre con sus propios campos.
* **Oferta:** cupones y descuentos.
* **Tarjeta de fidelización:** tarjetas de fidelización y 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.



### Rellenar los campos del pase

Los campos que ve 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*, horarios, andén, vagón, asiento) |

\* Requerido por Google.

<Aside type="note" title="Fechas y horas">
La mayoría de los tipos de pase utilizan ISO 8601 con un desplazamiento 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 desplazamiento (por ejemplo, `2026-09-01T06:30:00`).
</Aside>

#### Personalizar el contenido del pase

Cada pase está vinculado a un [User ID](/es/product/pushwoosh-knowledge-hub/users-userids/). Utilice marcadores de posición de Tag 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. Emita 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**), haga clic en `{}` para insertar una etiqueta.
2. En **TAG**, seleccione la [Tag](/es/product/audience-data-and-segmentation/user-data-tags/tags/) que desea insertar en el campo.
3. En **FORMAT**, elija cómo mostrar el valor de la etiqueta: **Tal cual** (usar el valor almacenado), **Entero** (redondear a un número entero), **Precio (0.00)** (mostrar dos decimales) o **Poner en mayúscula la primera letra** (poner en mayúscula la primera letra).
4. En **FALLBACK**, opcionalmente ingrese un texto para mostrar cuando el destinatario no tenga un valor para la etiqueta.
5. Haga clic en **Insertar**.

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

Pushwoosh rellena los valores de las etiquetas cuando crea el pase y los actualiza en cada actualización.


### Establecer la apariencia

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

#### Colores

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

#### Imágenes

<Aside type="caution" title="Aloje las imágenes en una URL HTTPS pública">
Google Wallet no almacena su logotipo o imagen principal. Aloje cada archivo en una **URL HTTPS pública** que permanezca en línea y accesible, luego pegue 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>

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

Opcionalmente, pegue 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 los 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 de la galería de medios">
Puede pegar una URL de imagen pública desde la [Galería 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 elimina la imagen en la Galería de medios, dejará de cargarse en el pase.
</Aside>

#### Quién puede guardar el pase

En **Quién puede guardar el pase**, seleccione 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 actualiza el pase, Google entrega el cambio a todos los titulares automáticamente.

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

#### Caducidad

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

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

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

1. **Formato:** elija 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íjalos solo si su 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, haga clic en `{}` junto al campo e inserte un [marcador de posición de Tag](#personalize-pass-content).
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 los campos Formato, Valor y Texto alternativo"/>

### Añadir 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ñada aquí.

* **Módulos de texto:** bloques de texto adicionales en el reverso del pase. Establezca un **encabezado** (el título de la sección) y un **cuerpo** (el texto). Úselos para términos, instrucciones u otra información que no quepa en el anverso.
* **Enlaces:** enlaces pulsables en el reverso del pase. Establezca 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 los campos de encabezado, cuerpo, URL y descripción"/>

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

En **ENLACE A LA APLICACIÓN**, añada un botón en el anverso del pase que abra una página web o su aplicación de Android al ser pulsado. Puede establecer una **URL**, un **nombre de paquete de Android**, o ambos.

Si solo establece la URL, el botón abrirá esa dirección web en cualquier dispositivo. Si solo establece un nombre de paquete, el botón funcionará 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 los campos de URL y nombre de paquete de Android"/>

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

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

Puede 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 puede establecer una distancia máxima por ubicación.
</Aside>

### Introducir un User ID

Introduzca 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/wallet-passes/google-wallet/#view-and-manage-existing-passes).

### Previsualizar y validar

Una **vista previa en vivo** se actualiza a medida que edita, para que pueda ver aproximadamente cómo se verá el pase en Google Wallet.

<Aside type="note" title="La vista previa puede diferir en un dispositivo">
La vista previa es una aproximación. Los pases con tipo utilizan 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, haga clic en **Validar**. El creador señalará los campos obligatorios que faltan y otros problemas.

## Generar el pase

Haga clic en **Generar**. Pushwoosh comprueba el pase y lo crea en Google Wallet. Obtendrá 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/wallet-passes/google-wallet/#view-and-manage-existing-passes).

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

## Gestionar 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/" />