Primeros pasos
Abrí Crear un pase, elegí qué querés hacer y editá. La vista previa de la derecha es lo que va a mostrar Wallet. Todo se guarda solo en tu navegador. No hace falta cuenta.
Usá Exportar proyecto para guardar un archivo .walletpassproject que podés importar en otra computadora.
Tipos de pase
Apple Wallet tiene un conjunto fijo de diseños. Vos elegís el contenido y el orden; Wallet decide las posiciones. Por eso no hay controles de posición x/y.
- Genérico: Membresías, credenciales, tarjetas de retiro y todo lo que no entra en otro estilo. Imágenes: Logo, Ícono, Miniatura.
- Tarjeta de comercio: Fidelidad, puntos, saldo de regalo y tarjetas de socio de comercios. Imágenes: Logo, Ícono, Franja.
- Cupón: Ofertas, descuentos y promociones de un solo uso. Imágenes: Logo, Ícono, Franja.
- Entrada: Recitales, congresos, festivales, cine y deportes. Imágenes: Logo, Ícono, Franja, Fondo, Miniatura.
- Pasaje: Vuelos, trenes, micros y ferries. Imágenes: Logo, Ícono, Pie.
- Genérico póster: Membresías y fidelidad con arte a pantalla completa (iOS 27+, en versiones anteriores se ve como Genérico). Imágenes: Logo, Ícono, Arte.
Las tarjetas de comercio, los cupones y los pases genéricos con código cuadrado admiten como máximo cuatro campos secundarios y auxiliares en total. El editor te avisa en vez de esconderlos sin decir nada.
Diseño
Tres colores definen un pase: fondo, texto y etiquetas. No cambian con el modo claro u oscuro de quien lo mira. Mantené el contraste del texto en 4.5:1 o más.
Las imágenes se recortan en tu navegador. Cuando generás un pase, el servidor crea los PNG en @1x, @2x y @3x. Apple exige un ícono; el logo es muy recomendable.
Precisión de Wallet (activada por defecto) muestra exactamente lo que dibuja Wallet. Desactivala para un modo libre que marca en rojo los campos ocultos. El pase generado siempre sigue las reglas de Apple.
Códigos
El código contiene los datos que indiques. Tu sistema tiene que saber interpretarlo o canjearlo.
- QR Code: todas las versiones de Wallet.
- PDF417: todas las versiones de Wallet.
- Aztec: todas las versiones de Wallet.
- Code 128: todas las versiones de Wallet. No se muestra en el Apple Watch.
- EAN-13: iOS 27 en adelante. Agregá un formato de respaldo para equipos anteriores. No se muestra en el Apple Watch.
- Code 39: iOS 27 en adelante. Agregá un formato de respaldo para equipos anteriores. No se muestra en el Apple Watch.
- Codabar: iOS 27 en adelante. Agregá un formato de respaldo para equipos anteriores. No se muestra en el Apple Watch.
- ITF: iOS 27 en adelante. Agregá un formato de respaldo para equipos anteriores. No se muestra en el Apple Watch.
Publicación
Generar un pase valida el diseño, procesa las imágenes, escribe pass.json y manifest.json, firma el paquete y produce un archivo .pkpass que se sirve como application/vnd.apple.pkpass. Cada pase publicado tiene una página con el botón Agregar a Apple Wallet en iPhone y un código QR en los demás dispositivos.
Para eso hace falta un certificado de firma en el servidor. Sin él, el editor funciona en modo vista previa.
Certificados de Apple Wallet
- En tu cuenta de Apple Developer, creá un Pass Type ID (por ejemplo,
pass.com.tuempresa.fidelidad). - Creá un certificado para ese ID. Podés generar el CSR en Linux con
openssl req -new -newkey rsa:2048 -nodes -keyout pass.key -out pass.csr. - Descargá el certificado y el certificado intermedio WWDR de Apple.
- Convertilo a PEM:
openssl x509 -inform der -in pass.cer -out pass.pem. - Configurá el servidor con el Pass Type ID, tu Team ID y las rutas de los archivos (ver el README). Las claves privadas nunca llegan al navegador y se guardan cifradas en la base de datos.
Google Wallet (Android)
Cada diseño también se ve como pase de Google Wallet. Cambiá la vista previa a Google Wallet en el editor para verlo. Google usa su propio diseño, así que el mismo contenido se ve distinto:
- El logo se muestra dentro de un círculo. Usá un logo cuadrado con algo de margen.
- La tarjeta muestra un título, un encabezado grande (tu campo principal), hasta 6 campos más en filas de a dos, el código y una imagen grande abajo (tu franja o arte).
- El texto es blanco o negro automáticamente, según el color de fondo. El color de etiquetas solo aplica a Apple Wallet.
- Los campos que no entran en la tarjeta aparecen en los detalles del pase.
Para emitir pases reales de Google Wallet hace falta una cuenta de emisor de Google Wallet (Google Pay & Wallet Console) y una cuenta de servicio de Google Cloud. Las cuentas nuevas arrancan en modo demo hasta que Google aprueba la publicación.
Trabajo con clientes
Studio está pensado para agencias: guardá el kit de marca de cada cliente, creá pases en minutos, mandá un link de revisión que el cliente aprueba sin cuenta, y después publicá y entregá un link, una página para agregar a Wallet y un kit de marketing con QR.
Pases dinámicos
Los pases de Wallet se pueden actualizar solos: puntos de 42 a 50, un nivel de Plata a Oro, una puerta de A a B. Agregale a un campo un mensaje de cambio con %@ y Wallet muestra una notificación cuando cambia. Las actualizaciones necesitan un servicio web registrado con cada dispositivo.
API
El diseño son datos estructurados: el mismo proyecto que guarda el editor se traduce a pass.json. La API planeada crea pases desde plantillas con variables como {{customer.name}}, autenticada con claves de API del espacio de trabajo.