Pases de Apple Wallet desde tu app de Base44: entradas, tarjetas de fidelidad, cupones
Si tu app de Base44 vende entradas para eventos, tiene un programa de fidelidad o reparte cupones, el pase debe estar en Apple Wallet, en la pantalla de bloqueo justo cuando hace falta. WebViewGold aporta la pieza que falta: cambia https:// por addpkpass:// en la URL de tu .pkpass e iOS muestra la hoja nativa de Añadir a Apple Wallet. Crear y firmar el pase sigue siendo cosa tuya, y en Android, Google Wallet funciona con su propio enlace web para guardar el pase.
Desde $109 de pago único por plataforma, o deja que nuestro equipo lo haga todo desde $698.
Garantía de aprobación – o te devolvemos el dinero en 14 días
Sin programar
Pago único, actualizaciones gratuitas
Soporte humano 24/7
Hecho en Alemania desde 2014 · ISO 27001
9:41
BBase44
Pases de Apple WalletYa en tu bolsillo
App Store · Google Play Aprobada
Cómo funciona Añadir a Apple Wallet en la app
Un enlace
<a href="addpkpass://yourdomain.com/passes/ticket-123.pkpass">: WebViewGold lo convierte de nuevo en una URL https:// y la abre en una pestaña de navegador dentro de la app, que reconoce el pase y muestra la vista previa nativa de Añadir a Apple Wallet.
Tú creas y firmas el pase
Un archivo .pkpass es un paquete firmado (pass.json, imágenes, un manifiesto y una firma) creado con tu propio certificado de Pass Type ID de tu cuenta de Apple Developer. Genéralo en tu servidor o con un servicio de pases; WebViewGold se lo entrega a Wallet.
Sírvelo correctamente
HTTPS, el tipo MIME application/vnd.apple.pkpass y una firma válida. Si falla cualquiera de los tres, iOS no puede mostrar la vista previa y el usuario ve un error en su lugar.
Android: Google Wallet
Desde 2024, Google Wallet puede importar muchos archivos .pkpass, pero la compatibilidad varía según el dispositivo y el pase, y el esquema addpkpass:// es exclusivo de iOS. La vía fiable en Android es un pase de Google Wallet creado con la Google Wallet API y el botón oficial Añadir a Google Wallet, que enlaza a una URL de guardado en pay.google.com firmada por tu servidor.
Prompt para Base44
Pega esto en Base44 para implementar la parte de la web app. Revisa el resultado, publica y luego prueba dentro de la app WebViewGold.
Prompt para pegar en Base44
Añade botones Añadir a Apple Wallet para las entradas, usando el envoltorio iOS de WebViewGold. Añade los campos pass_url y google_wallet_url a la entidad Ticket. Crea una función de backend createWalletPass(ticket_id) que compruebe que la entrada pertenece al usuario actual, envíe el nombre del evento, la fecha, el lugar, el código de la entrada y el nombre del titular a la API de nuestro proveedor de pases con la clave de API guardada como secreto, y guarde la URL de descarga del pase de Apple devuelta en pass_url y el enlace de guardado de Google Wallet en google_wallet_url. Llámala automáticamente cuando se cree una entrada. En la página de la entrada: si navigator.userAgent contiene mi token personalizado de WebViewGold y el dispositivo es un iPhone o iPad, muestra la insignia Añadir a Apple Wallet enlazando a pass_url con https:// sustituido por addpkpass://; en Safari, enlaza directamente a pass_url; en Android, muestra un botón Añadir a Google Wallet que enlace a google_wallet_url. Si todavía no existe ningún pase, muestra el código QR de la entrada y un botón Reintentar.
WebViewGold nos ha permitido el tiempo de mercado más corto y eficiente que jamás sea posible de todas las otras plataformas de aplicaciones que hemos probado durante los últimos 5 años. No sé por qué no lo había descubierto antes, ¡pero estoy muy, muy contento de haberlo hecho. Actualmente cerca de 6000 descargas de aplicaciones tanto en iOS App Store & Google Play Store sin ningún problema!
Apple Wallet tiene cinco estilos de pase: entrada para eventos, tarjeta de tienda, cupón, tarjeta de embarque y genérico. Los que más aparecen:
Entradas para eventos
Talleres, meetups, conciertos, clases. Un código QR con el ID de la entrada, la fecha y el lugar, y una fecha relevante para que el pase aparezca en la pantalla de bloqueo antes del evento.
Tarjetas de fidelidad y de sellos
Cafeterías, salones de belleza, gimnasios. Una tarjeta de tienda con el número de socio como código de barras y un saldo de puntos que puedes actualizar más adelante.
Cupones y ofertas
Un código de descuento que se escanea en el mostrador o se muestra al pagar, con una fecha de caducidad que el usuario puede ver.
Membresías y accesos
Membresías de clubes, acceso a coworkings, pases VIP o de temporada: la identificación es uno de los usos que Apple menciona de forma explícita.
Añade pases de Wallet a una app de Base44
Un día para el primer tipo de pase; lo que más tarda son los certificados.
Crea un Pass Type ID y su certificado
En tu cuenta de Apple Developer, en Certificates, Identifiers & Profiles, registra un Pass Type ID (por ejemplo pass.com.yourcompany.tickets), crea su certificado y descarga el certificado intermedio WWDR de Apple. Ambos van a tu servidor, nunca al cliente.
Genera los pases en tu servidor
Una función de servidor en Entidades integradas de Base44 (base de datos), almacenamiento de archivos y funciones de backend crea el pass.json (número de serie, código de barras con el código de la entrada, fecha o ubicación relevante) y lo firma, por ejemplo con passkit-generator en Node o con una API de pases alojada. Guarda el número de serie junto con el pedido.
Protege la descarga con un token
Puede que la pestaña de navegador dentro de la app no comparta las cookies de sesión del WebView, así que dale a la URL del pase un token firmado y de corta duración en lugar de depender de la sesión iniciada.
Añade el botón
Usa la insignia oficial de Apple Añadir a Apple Wallet. Dentro de la app de iOS, enlaza el pase con addpkpass://; en Safari, el enlace https normal funciona de forma nativa; en Android, muestra el botón de Google Wallet o una entrada en PDF.
Mantén los pases al día (opcional)
Añade webServiceURL y authenticationToken al pass.json e implementa el servicio web de pases de Apple; cuando cambien una puerta, un asiento o un saldo de puntos, notificas al dispositivo por APNs y Wallet descarga la nueva versión.
Prueba en un iPhone real
Añade un pase, ábrelo desde la pantalla de bloqueo, prueba un token caducado y una entrada anulada. Comprueba que el código de barras se escanea con el lector que de verdad usas en el acceso.
Un solo helper para todas las plataformas
Tu servidor devuelve ambas URLs; la página elige la correcta. YourAppToken es el user agent personalizado de Config.swift / Config.java.
javascript
var ua = navigator.userAgent;
var inApp = ua.indexOf("YourAppToken") !== -1;
var isIOS = /iPhone|iPad|iPod/.test(ua);
var isAndroid = /Android/.test(ua);
// pass = {
// pkpassUrl: "https://yourdomain.com/passes/T-1042.pkpass?t=SIGNED_TOKEN",
// googleSaveUrl: "https://pay.google.com/gp/v/save/SIGNED_JWT", // lo genera tu servidor
// pdfUrl: "https://yourdomain.com/tickets/T-1042.pdf"
// }
function walletLink(pass) {
if (isIOS && inApp) return pass.pkpassUrl.replace(/^https:\/\//, "addpkpass://");
if (isIOS) return pass.pkpassUrl; // Safari abre .pkpass de forma nativa
if (isAndroid && pass.googleSaveUrl) return pass.googleSaveUrl;
return pass.pdfUrl; // escritorio y respaldo
}
document.getElementById("add-to-wallet").href = walletLink(window.currentPass);
Android y Google Wallet
WebViewGold no tiene una API específica para Google Wallet, y el esquema addpkpass:// es exclusivo de iOS. La vía web funciona bien:
Crea una cuenta de emisor en Google Pay & Wallet Console, define una clase de pase (entrada para eventos, fidelidad, oferta o genérico) y deja que tu servidor firme un JWT con una cuenta de servicio. El resultado es un enlace de guardado en pay.google.com.
Abre ese enlace fuera del WebView, donde el usuario tiene iniciada su sesión de Google: añade pay.google.com a BROWSER_BLACKLIST en Config.java, o antepón newtab: al enlace y pon SPECIAL_LINK_HANDLING_OPTIONS en 2 (documentación sobre el manejo de URLs).
Usa el diseño oficial del botón Añadir a Google Wallet y sigue sus directrices de marca, igual que usas la insignia de Apple en iOS.
Las versiones recientes de Google Wallet también pueden importar archivos .pkpass, pero tómalo como un extra que pruebas en tus dispositivos de destino, no como el plan: dentro de la app no hay gestión de Wallet para enlaces .pkpass en Android.
Ten siempre un respaldo: una entrada en PDF o el código QR en pantalla funcionan en cualquier dispositivo.
Preguntas frecuentes
¿WebViewGold crea el pase de Wallet por mí?
No. WebViewGold entrega un pase a Apple Wallet. La creación y la firma del archivo .pkpass se hacen en tu servidor o en un servicio de pases, con tu propio certificado de Pass Type ID del Apple Developer Program.
¿Funciona Añadir a Apple Wallet en Android?
Apple Wallet solo existe en dispositivos de Apple. Google Wallet puede importar muchos archivos .pkpass en teléfonos Android recientes, pero la compatibilidad varía, así que la vía fiable es un pase de Google Wallet creado con la Google Wallet API, con su enlace de guardado abierto fuera del WebView (BROWSER_BLACKLIST en Config.java), donde el usuario tiene iniciada su sesión de Google. WebViewGold no tiene una API específica para Google Wallet.
¿Puedo actualizar un pase después de que el usuario lo haya añadido?
Sí, con el servicio web de pases de Apple: incluye webServiceURL y authenticationToken en pass.json y Wallet registra el dispositivo en tu servidor. Cuando cambien la puerta, el asiento o el saldo, envías un push a través de APNs y Wallet descarga la nueva versión.
¿Por qué se abre el pase en una pestaña de navegador dentro de la app?
Esa pestaña reconoce el tipo de contenido .pkpass y muestra la vista previa nativa de Añadir a Apple Wallet. Puede que no comparta las cookies con el WebView principal, así que la URL del pase tiene que funcionar sin la sesión de la app, por ejemplo con un token firmado que caduque.
¿Pueden los usuarios añadir pases también desde el sitio web?
Sí. Safari en iPhone y Mac abre los enlaces .pkpass de forma nativa, así que la misma URL https funciona en la web; solo la app usa el prefijo addpkpass://.
Tres formas de llevar tu app a las tiendas
El mismo resultado, con distinta cantidad de trabajo por tu parte. Las tres incluyen la garantía de aprobación y soporte humano 24/7.
Hazlo tú mismo
$109 por plataforma, pago único
La licencia de WebViewGold: un proyecto de Xcode o Android Studio listo para usar. Pega tu URL, define nombre e icono, activa funciones, compila y envía. Actualizaciones gratuitas para siempre.
Sin Mac, sin Xcode, sin Android Studio: configura en el navegador, compilamos ambas apps en la nube y las entregamos a App Store Connect y a Play Console.
Envíanos tu URL y tu icono. Nuestro equipo configura, compila y entrega tu app en 72 horas, en marca blanca y con los proyectos fuente. Ambas plataformas por $1,158.
Los reembolsos se conceden bajo las condiciones indicadas en nuestras FAQ: un rechazo por motivos ajenos al contenido por parte de Apple y/o Google, reclamado dentro de los 14 días posteriores a la compra.