# Diseñar pases en el creador de pases

El **creador de pases** de Apple Wallet es un diseñador visual en el Panel de Control. Usted elige un estilo de pase, completa la marca, los campos y un código de barras, ve una vista previa en vivo y genera un archivo `.pkpass` firmado, sin necesidad de escribir `pass.json` a mano.

## Crear un pase

En el Panel de Control, vaya a **Campañas → Apple Wallet** y haga clic en **Crear pase**.

<img src="/apple-wallet-passes-pass-builder-1.webp" alt="Página de todos los pases con el botón Crear pase y columnas de la tabla para el nombre del pase, estilo, usuario y última actualización"/>

## Configurar el pase

   * **Desde cero:** comience con un pase vacío. Elija un estilo de pase, luego configure los colores, imágenes, campos, 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 incorporado en **Seleccionar plantilla** (pase de abordar, cupón, boleto de evento, genérico o tarjeta de tienda) y confirme. El formulario rellena previamente el estilo del pase, los colores, las imágenes, los campos del pase, el código de barras y la información básica. Edite cualquier valor o cambie el estilo según sea necesario. Pushwoosh reemplaza los ID de equipo y de tipo de pase de la plantilla con los valores de su aplicación.

### Elija un estilo de pase

En **ESTILO DE PASE**, elija uno de los cinco estilos de pase de Apple Wallet. El estilo controla el diseño y qué áreas de campo e imágenes están disponibles:

* **Pase de abordar**
* **Cupón**
* **Boleto de evento**
* **Tarjeta de tienda**
* **Genérico**


Si comienza desde cero, elija el estilo antes de añadir campos e imágenes.
Cambiar el estilo restablece los campos específicos del estilo.

### Añada el nombre y la descripción del pase

En **INFORMACIÓN BÁSICA**, complete:

| |  |
| :---- | :---- |
| **Nombre del pase** | El título del pase y el nombre de la fuente que se muestra en las notificaciones de actualización. |
| **Descripción** | Una breve descripción del pase. |
| **Texto del logo** | Texto que se muestra junto al logo (se usa cuando no se ha subido ninguna imagen de logo). |

<img src="/apple-wallet-passes-pass-builder-2.webp" alt="Sección de información básica con los campos Nombre del pase, Descripción y Texto del logo"/>

### Establezca colores e imágenes

#### Colores

En **COLORES**, establezca:

* **Color de fondo:** el fondo del pase.
* **Color de primer plano:** texto principal e íconos en el pase.
* **Color de la etiqueta:** color de las etiquetas de los campos (por ejemplo, `FROM`, `GATE`).

Para establecer o cambiar un color, haga clic en su campo y elija un color en el selector.

<Aside type="note">
Los colores se almacenan en formato `rgb(r, g, b)`.
</Aside>

<img src="/apple-wallet-passes-pass-builder-3.webp" alt="Sección de Colores con los campos Color de fondo, Color de primer plano y Color de la etiqueta"/>

#### Imágenes

En **IMÁGENES**, suba el **Ícono** y el **Logo** (ambos requeridos). Las imágenes opcionales dependen del estilo del pase.

Haga clic en **Elegir archivo** junto a cada ranura de imagen. Suba archivos PNG o JPEG. Pushwoosh procesa cada imagen en las resoluciones que Apple requiere (@1x, @2x, @3x) cuando genera el pase.

### Rellene los campos del pase

En **CAMPOS DEL PASE**, añada el texto y los valores que aparecen en el pase. Los grupos que vea dependen del estilo del pase:

* **Campos de encabezado (parte superior del pase):** Pase de abordar, Boleto de evento
* **Campos primarios (contenido principal):** todos los estilos
* **Campos secundarios (información de apoyo):** todos los estilos
* **Campos auxiliares (detalles adicionales):** todos los estilos
* **Campos posteriores (reverso del pase):** todos los estilos

Haga clic en **+ Añadir campo** en cada grupo que necesite.

Para cada campo, establezca:

|  |  |
| :---- | :---- |
| Clave (ID) | Identificador de campo único (generado automáticamente). |
| Etiqueta | Etiqueta corta en el pase (por ejemplo, `FROM`). |
| Valor | Valor que se muestra en el pase (por ejemplo, `SFO`). |
| Mensaje de cambio | Texto en la notificación de actualización cuando este valor cambia. Se muestra solo cuando el valor cambia. Use `%@` para el nuevo valor (por ejemplo, `Puerta cambiada a %@`). |

<img src="/apple-wallet-passes-pass-builder-8.webp" alt="Campo de pase con botón de Formato y opciones de formato expandidas para el formato del valor y la alineación del texto"/>

En la tarjeta del campo, haga clic en **Formato** para mostrar las opciones de formato. Haga clic en **X** para eliminar el campo.


#### Opciones de formato

* **Formato del valor:** Texto, Fecha y hora, o Número/moneda.
* **Alineación del texto:** Predeterminada (Natural), izquierda, centro o derecha.
* **Detectores de datos** *(solo campos posteriores):* convierta números de teléfono, enlaces, direcciones y eventos de calendario en contenido pulsable en los campos posteriores.


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

En **CÓDIGO DE BARRAS**, elija un formato e ingrese los datos a codificar:

1. **Formato del código de barras:** elija cómo se ve el código de barras y qué tipo de escáner puede leerlo.
   * **Código QR (recomendado):** código cuadrado que la mayoría de los teléfonos y escáneres leen fácilmente. Ideal para cupones, tarjetas de fidelidad y la mayoría de los pases.
   * **PDF417:** código de barras ancho compuesto por varias filas de líneas. A menudo se requiere para pases de abordar de aerolíneas o de tránsito.
   * **Aztec:** código cuadrado compacto, similar al QR. Común en boletos de eventos y de tránsito.
   * **Code 128:** código de barras clásico de líneas verticales. Elija este solo si su escáner o sistema POS requiere un código de barras 1D.
2. **Mensaje del código de barras:** el valor codificado en el código de barras (por ejemplo, un número de boleto o de membresía).
3. **Texto alternativo (opcional):** texto que se muestra debajo del código de barras en el pase.

<img src="/apple-wallet-passes-pass-builder-6.webp" alt="Sección de CÓDIGO DE BARRAS con menú desplegable de formato, campo de mensaje del código de barras y campo de texto alternativo opcional"/>

### Establezca el vencimiento y el estado

En **VENCIMIENTO Y ESTADO**, controle cuándo se muestra el pase, cuándo vence y si todavía es válido:

* **Fecha relevante (cuándo mostrar el pase):** fecha y hora en que el pase puede aparecer en la pantalla de bloqueo.
* **Fecha de vencimiento (cuándo vence el pase):** fecha y hora después de la cual el pase aparece atenuado en Wallet.
* **Marcar como anulado (invalidar este pase):** casilla de verificación para invalidar el pase para que ya no se pueda usar.

<img src="/apple-wallet-passes-pass-builder-7.webp" alt="Sección de Vencimiento y estado con fecha relevante, fecha de vencimiento y casilla de verificación de anulado"/>

### Opciones específicas de estilo y avanzadas

* **Tipo de tránsito** *(solo Pase de abordar):* Aéreo, Tren, Autobús, Barco o Genérico.
* **Identificador de agrupación:** agrupe pases relacionados en Wallet.

### Relevancia basada en la ubicación *(opcional)*

En **RELEVANCIA BASADA EN LA UBICACIÓN**, el pase aparece cuando el usuario está cerca de las ubicaciones que usted añade. Para cada ubicación, establezca el texto que se muestra en la pantalla de bloqueo cuando el usuario está cerca. Puede añadir hasta 10 ubicaciones.

Haga clic en el mapa, busque una dirección, pegue coordenadas o importe una geozona para añadir un punto. Arrastre el marcador para ajustar la posición.

Una **distancia máxima** (en metros) controla qué tan cerca debe estar el usuario para que el pase siga siendo relevante.

<img src="/apple-wallet-passes-pass-builder-5.webp" alt="Sección de relevancia basada en la ubicación con mapa, lista de ubicaciones, texto de la pantalla de bloqueo y campo de distancia máxima" width="600"/>

<Aside type="note" title="Ubicaciones vs. balizas">
La sección **RELEVANCIA BASADA EN LA UBICACIÓN** solo configura ubicaciones basadas en mapas. Usted define un lugar y una **distancia máxima** en metros. El dispositivo utiliza los servicios de ubicación para decidir cuándo el usuario está lo suficientemente cerca. Wallet puede entonces mostrar el texto de su pantalla de bloqueo para esa ubicación.

PassKit también puede vincular un pase a hardware iBeacon en interiores. Esa opción no está disponible en el creador de pases. Configure las balizas en la [API de PassKit](/es/developer/api-reference/apple-wallet-passkit-api/) cuando su equipo utilice transmisores de balizas.
</Aside>

**Ejemplos de casos de uso**

* **Venta minorista:** una tarjeta de fidelidad o un cupón aparece cuando el cliente está cerca de su tienda. El texto de la pantalla de bloqueo podría decir que está cerca de la tienda y recordarle que use el pase.
* **Eventos:** un boleto de evento aparece cuando el usuario está cerca del lugar (estadio, teatro o recinto del festival) para que pueda encontrar el pase rápidamente en la entrada.
* **Viajes:** un pase de abordar se vuelve prominente cerca del aeropuerto o terminal de salida, para que el pasajero vea los detalles de la puerta o del vuelo en la pantalla de bloqueo antes de abrir Wallet.
* **Hostelería:** un cupón o pase de membresía puede aparecer cerca de una cafetería u hotel que usted defina.

### Ingrese un ID de Usuario

Ingrese el [ID de Usuario](/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 en **USUARIO** en **Todos los pases**.

### Previsualice y valide

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

<Aside type="note" title="La vista previa puede diferir en un dispositivo">
La vista previa es una aproximación. El pase puede verse diferente en un dispositivo real. El código de barras que se muestra es un marcador de posición. El código de barras real se genera en el archivo `.pkpass` final.
</Aside>

Para verificar el pase con las especificaciones de Apple sin crearlo, haga clic en **Validar pase**. El creador marca las imágenes requeridas faltantes y otros problemas.

## Genere el pase

Seleccione **Generar**. Pushwoosh valida el pase, procesa las imágenes y firma el paquete. La generación toma unos segundos, después de lo cual el pase aparece en su lista de pases.

Para editar (incluida la actualización por número de serie), descargar, compartir y eliminar pases después de la generación, consulte [Gestionar pases existentes](/es/product/messaging-channels/apple-wallet-passes/#view-and-manage-existing-passes).


## Gestione 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 del Diseñador PassKit](/es/developer/api-reference/apple-wallet-passkit-api/): crear, actualizar, listar, descargar y eliminar pases.

<LinkCard title="API PassKit de Apple Wallet" href="/developer/api-reference/apple-wallet-passkit-api/" />